Skip to content
Documentation menu
docs / api / get-v1-navigation-sessions-id
Routing

GET/v1/navigation/sessions/{id}

Access and price

AuthAn API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused.
PriceNot metered: no quota, no credit.

What it does

Read a session back: its route, last state and what is left to go. Free.

An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit.

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/v1/navigation/sessions/{id}" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

NameInTypeRequiredDescription
idpathstringyesThe session id

Responses

200The session as of its last accepted fix. Free: reading never spends units. Counts as activity for the idle time
FieldTypeRequiredDescription
costingstringyesCosting.
expires_atstringyesWhen the session expires if left idle from now.
next_instructionInstructionyesThe next instruction as of the last accepted fix.
privacystringyesWhat the session keeps.
remaining_mnumbernoMetres still to go as of the last accepted fix.
remaining_snumbernoSeconds still to go as of the last accepted fix.
reroutesintegeryesReroutes so far.
routeRouteSummaryyesThe route being guided.
session_idstringyesThe session.
statestringyesThe last state reported, or created before the first fix.

Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "costing": "string",
  "expires_at": "string",
  "next_instruction": {
    "maneuver_type": 0,
    "step_index": 0,
    "street_names": [
      "string"
    ],
    "text": "string"
  },
  "privacy": "string",
  "reroutes": 0,
  "route": {
    "distance_m": 0,
    "duration_s": 0,
    "geometry_polyline6": "string",
    "steps": 0,
    "version": 0
  },
  "session_id": "string",
  "state": "string"
}
401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (unauthorized)

application/problem+json · Problem

403A browser (maps-scoped) key on a route that needs a full-scope key (scope-insufficient)

application/problem+json · Problem

404No such session for this key

application/problem+json · Problem

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

Error bodies follow the shared problem model documented on API conventions.

Also under Routing

Generated from https://api.mapmap.ai/openapi.json on 2026-11-22 · operationId get_session