GET/directions-matrix/v1/{user}/{profile}/{coordinates}

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/directions-matrix/v1/{user}/{profile}/{coordinates}" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
user	path	yes	`mapbox` or `mapmap`
profile	path	yes	`driving`, `driving-traffic` (served as `driving`), `walking`, `cycling` or `truck` (premium)
coordinates	path	yes	`lon,lat` pairs separated by `;`
access_token	query	no	Your MapMap key (`snk_...`)
sources	query	no	`;`-separated coordinate indices, or `all` (default)
destinations	query	no	`;`-separated coordinate indices, or `all` (default)
annotations	query	no	`duration` (default), `distance`, or both comma-separated
depart_at	query	no	Local departure time, `YYYY-MM-DDThh:mm`

Responses

200{code, durations, distances?, sources, destinations}; waypoints carry the input coordinate and an empty name (the engine reports no snapped position). Metered as POST /matrix: one unit per started block of 25 elements

400{code, message} for a malformed or unsupported option, not billed

401Missing or invalid key

404ProfileNotFound

422More than 10,000 elements, or a span beyond the engine's matrix distance

429Quota or rate limit exceeded

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

Also under mapbox-compat

GET /directions/v5/{user}/{profile}/{coordinates}GET /geocoding/v5/mapbox.places/{query}GET /isochrone/v1/{user}/{profile}/{coordinates}GET /optimized-trips/v1/{user}/{profile}/{coordinates}GET /search/geocode/v6/forward GET /search/geocode/v6/reverse

Generated from https://api.mapmap.ai/openapi.json on 2026-10-17 · operationId get_matrix