Developers

list_hikes

Hikes with their spot and place links.

GET/v1/guides/{productId}/hikes
MCP tool list_hikesScope: readBetaSince 2026-10-06.8
Markdown

Every hike of the guide by name, with its difficulty and grade, figures, transit notes, equipment, sources, line and the ordered spot and place links.

curl "https://sceniq.earth/api/v1/guides/j5738kd1q9x2m7v4c6b8n0p3r5t1w9y2/hikes" \
  -H "Authorization: Bearer $SCENIQ_API_KEY"

Path parameters

Returns

200 OK with this object.

  • productIdstring · guide idrequired

    The guide's id.

  • hikesarray of Hikerequired

    Every hike, by name.

    Show 19 fieldsof Hike
    • hikeIdstring · hike idrequired

      The hike's id.

    • namestring or nullrequired

      The hike's name.

    • difficultystring or nullrequired

      easy, moderate, hard or expert; null when unset.

      easymoderatehardexpert
    • gradestring or nullrequired

      The grade as written (T3, K2, Class 3); null when unset.

    • durationMinnumber or nullrequired

      Walking time in minutes.

    • gainMnumber or nullrequired

      Elevation gain in meters.

    • descentMnumber or nullrequired

      Descent in meters.

    • distanceKmnumber or nullrequired

      Distance in kilometers.

    • startstring or nullrequired

      The trailhead in words.

    • startMapsUrlstring or nullrequired

      Map link to the trailhead.

    • transitarray of TransitNoterequired

      Transit notes per mode.

      Show 2 fieldsof TransitNote
      • modestringrequired

        train, bus, cable_car, car, boat, ferry or plane (shown as Flight).

        trainbuscable_carcarboatferryplane
      • notestringrequired

        The note in words: the connection, where to change, the last departure.

    • descriptionstring or nullrequired

      The hike in the creator's words.

    • equipmentarray of strings or nullrequired

      Gear; [] means explicitly none, null means unknown.

    • sourcesarray of stringsrequired

      Where the facts come from.

    • trackHikeTrack or nullrequired

      The hike's line.

      Show 3 fieldsof HikeTrack
      • coordinatesarray of array of numbersrequired

        Positions as [lon, lat] or [lon, lat, ele] (ele in meters), 2 to 1,000. Stored rounded to 6 decimals and whole meters.

      • sourcestringoptional

        The file type the line came from: gpx or kml. Other values are dropped.

      • fileNamestringoptional

        The imported file's name, cut to 200 characters.

    • createdAtnumberrequired

      When the row was created (Unix time in milliseconds).

    • updatedAtnumberrequired

      When the row last changed (Unix time in milliseconds).

    • spotsarray of objectsrequired

      The spots the hike goes to, in order.

      Show 2 fields
      • spotKeystringrequired

        The spot's key.

      • ordernumberrequired

        Position on the hike.

    • facilitiesarray of objectsrequired

      The places the hike uses, in order.

      Show 2 fields
      • facilityIdstringrequired

        The place's id: its helper pin's spot id (a place written before helpers keeps answering to its old id).

      • ordernumberrequired

        Position on the hike.

Response 200
{
  "productId": "j5738kd1q9x2m7v4c6b8n0p3r5t1w9y2",
  "hikes": [
    {
      "hikeId": "kx7f2h8j4k0k6z2x8c4v0b6n2m8q4w0e",
      "name": "Fairy Falls trail to the Grand Prismatic overlook",
      "difficulty": "easy",
      "grade": null,
      "durationMin": 45,
      "gainM": 35,
      "descentM": 35,
      "distanceKm": 2,
      "start": "Fairy Falls trailhead on the Grand Loop Road, 1.6 km south of Midway Geyser Basin",
      "startMapsUrl": "https://maps.apple.com/?ll=44.5156,-110.8326&q=Fairy%20Falls%20Trailhead",
      "transit": [
        {
          "mode": "car",
          "note": "Park at the Fairy Falls trailhead lot, which fills by 09:30 in July and August. No public transport runs in the park."
        }
      ],
      "description": "A flat kilometer on the old Fountain Freight Road, then a short climb to a platform above Grand Prismatic Spring. Go mid morning on a warm day, once the steam has lifted.",
      "equipment": [
        "Bear spray",
        "A warm layer for the morning"
      ],
      "sources": [
        "https://www.nps.gov/places/000/grand-prismatic-spring.htm",
        "GPX recorded by Mara Lindgren on 2026-09-14"
      ],
      "track": null,
      "createdAt": 1789895640000,
      "updatedAt": 1790586840000,
      "spots": [
        {
          "spotKey": "01M2Z1G0Y0QG7M2V6N9R3T5W8Y",
          "order": 1024
        }
      ],
      "facilities": [
        {
          "facilityId": "k17d4f6g8h0j2k4k6z8x0c2v4b6n8m0q",
          "order": 1024
        }
      ]
    },
    {
      "hikeId": "kx7r4t6y8v0j2p4p6a8s0d2f4g6h8j0k",
      "name": "Inspiration Point from Tunnel View",
      "difficulty": "moderate",
      "grade": "Class 1",
      "durationMin": 120,
      "gainM": 305,
      "descentM": 305,
      "distanceKm": 4.2,
      "start": "Pohono Trail sign at the Tunnel View parking",
      "startMapsUrl": "https://www.google.com/maps/search/?api=1&query=37.7156,-119.677",
      "transit": [],
      "description": "Steep switchbacks up the Pohono Trail to a quieter, higher version of the Tunnel View frame. Most of the climb is in full sun.",
      "equipment": [
        "Two liters of water per person"
      ],
      "sources": [
        "GPX recorded by Mara Lindgren on 2026-06-11"
      ],
      "track": null,
      "createdAt": 1789895640000,
      "updatedAt": 1790586840000,
      "spots": [
        {
          "spotKey": "01M2Z1G0Y0R2K5P8S1V4X7Z0C3",
          "order": 1024
        }
      ],
      "facilities": []
    }
  ]
}

Errors

Every error is { error: { code, message } }. Act on the code.

  • 400invalid_argumentA required field is missing, a field is unknown, or a value does not match its type (the Convex validator's path and value are in the message).
  • 401unauthenticatedThe request carries no key. Send it as Authorization: Bearer sk_sceniq_... (or X-Api-Key).
  • 401invalid_api_keyThe key is unknown, revoked or expired.
  • 403forbiddenThe key belongs to a creator account that is no longer active.
  • 404not_foundThe id does not exist or belongs to another creator. The two answers are identical on purpose, so ids never reveal what exists.
  • 429rate_limitedOver a limit: requests per key per minute, per creator per hour, uploads per key per minute, or check_links per guide per hour.
  • 500internal_errorAn unexpected failure. The message is hidden on purpose.