Get started

Catalogs

Activities

The activity catalog (hiking, ski touring, road cycling and the rest) grouped by category. Each activity declares what routing is available for it, which is what decides whether a segment can be auto-routed or has to be drawn by hand.

The Activity object

An outdoor activity type with its capabilities.

capabilities

object

required

What the routing engine can do for this activity. Read it before offering a mode: an activity that cannot be routed accepts linestring segments only, and a client that offers directions anyway produces a request the server refuses.

id

string (uuid)

required

Unique identifier of the activity.

locales

object

required

The activity's display name per language. Render from here rather than from slug: the slug is a stable identifier and is not translated.

slug

string

required

One of: hiking-and-trail, professional-trail, running, road-cycling, gravel-bike, mountain-bike, backcountry-skiing, ski-touring, cross-country-skiing, snowshoe-walking

Stable identifier for the activity, the same on every surface and safe to store. id is the value operations take; this is the value a human reads in a URL or a config file.

List all activity categories and their activities

Returns all available activities grouped by category. Each activity includes its capabilities (e.g., routing support, elevation profiles). It is a catalog, the same for every caller, so it is not paged: every category comes back at once.

Response 200

The activity catalog, grouped by category. Each activity declares what the routing can do for it.

extensions

object

Top-level extensions map for 2xx responses. Mirrors the GraphQL-spec response extensions: a free-form map for response-scoped metadata.

data

array of CategoryActivities

required

Errors 400, 401, 402, 403, 429, 500, 504. See Errors.

curl -s https://api.mountaya.com/v1/activities \
  -H "X-API-Key: pk_your_publishable_key" | jq '.data'
200
Response
{
  "data": [
    {
      "id": "8f2c6b41-0d75-4a39-9e18-c3b5a7d02f96",
      "slug": "foot",
      "locales": {
        "de": null,
        "en": {
          "name": "On foot"
        },
        "es": null,
        "fr": {
          "name": "À pied"
        },
        "it": null,
        "ja": null,
        "zh": null
      },
      "children": [
        {
          "id": "a1c4e7b2-3d59-4f08-8b6a-2e5c9d0f7134",
          "slug": "hiking-and-trail",
          "locales": {
            "de": null,
            "en": {
              "name": "Hiking & trail"
            },
            "es": null,
            "fr": {
              "name": "Randonnée et trail"
            },
            "it": null,
            "ja": null,
            "zh": null
          },
          "capabilities": {
            "analysis": true,
            "default_speed": 4.5,
            "directions": true,
            "linestring": true
          }
        }
      ]
    }
  ]
}