Documentation menu
Routing
GET/v1/navigation/sessions/{id}
Access and price
| Auth | An 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. |
|---|---|
| Price | Not 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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | The session id |
Responses
200The session as of its last accepted fix. Free: reading never spends units. Counts as activity for the idle time
| Field | Type | Required | Description |
|---|---|---|---|
| costing | string | yes | Costing. |
| expires_at | string | yes | When the session expires if left idle from now. |
| next_instruction | Instruction | yes | The next instruction as of the last accepted fix. |
| privacy | string | yes | What the session keeps. |
| remaining_m | number | no | Metres still to go as of the last accepted fix. |
| remaining_s | number | no | Seconds still to go as of the last accepted fix. |
| reroutes | integer | yes | Reroutes so far. |
| route | RouteSummary | yes | The route being guided. |
| session_id | string | yes | The session. |
| state | string | yes | The 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
POST /centroidPOST /locatePOST /routePOST /route/alongPOST /route/progressPOST /route/reportGET /route/v1/{profile}/{coordinates}POST /trace_attributesPOST /trace_routePOST /v1/camera-incidentsPOST /v1/cameras/alongPOST /v1/errands/planPOST /v1/incidents/alongPOST /v1/navigation/sessionsDELETE /v1/navigation/sessions/{id}POST /v1/navigation/sessions/{id}/progressPOST /v1/route/heritagePOST /v1/route/observationsGET /v1/zones
Generated from https://api.mapmap.ai/openapi.json on 2026-11-22 · operationId get_session