GET/optimized-trips/v1/{user}/{profile}/{coordinates}

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

What it does

A one-vehicle optimisation of 2 to 12 stops, then the route of the ordered trip. Billed as the optimise units plus the route units: 11 units for a trip of up to 12 coordinates (10 for the solve, 1 for the route); when the order is forced no solve runs and only the route is billed.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/optimized-trips/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	2 to 12 `lon,lat` pairs separated by `;`; the first is the start
access_token	query	no	Your MapMap key (`snk_...`)
roundtrip	query	no	Return to the first coordinate (default `true`)
source	query	no	`any` (default) or `first`
destination	query	no	`any` (default) or `last`
steps	query	no	Turn-by-turn steps on the trip
geometries	query	no	`polyline` (default), `polyline6` or `geojson`
overview	query	no	`simplified` (default), `full` or `false`
annotations	query	no	As on Directions: `distance`, `duration`, `speed`, `maxspeed`

Responses

200{code, waypoints: [{waypoint_index, trips_index, location, name}], trips: [<route>]}. NotImplemented (an unsupported roundtrip/source/destination combination, not billed), NoTrips and NoRoute also answer 200 with that code

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

401Missing or invalid key

404ProfileNotFound

429Quota or rate limit exceeded

503Optimisation is not enabled on this deployment

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

Also under mapbox-compat

GET /directions-matrix/v1/{user}/{profile}/{coordinates}GET /directions/v5/{user}/{profile}/{coordinates}GET /geocoding/v5/mapbox.places/{query}GET /isochrone/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_optimized_trips