---
title: "Mapbox-compatible Directions (see module docs). Metered exactly as `GET /route/v1`: one unit per started block of 20 waypoints, premium on the `truck` profile."
method: GET
path: "/directions/v5/{user}/{profile}/{coordinates}"
tags: ["mapbox-compat"]
---

# Mapbox-compatible Directions (see module docs). Metered exactly as \`GET /route/v1\`: one unit per started block of 20 waypoints, premium on the \`truck\` profile.

`GET /directions/v5/{user}/{profile}/{coordinates}`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/directions/v5/{user}/{profile}/{coordinates}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Path parameters

- `user` string, required
- `profile` string, required
- `coordinates` string, required

## Query parameters

- `access_token` string
- `alternatives` boolean
- `annotations` string
- `geometries` string
- `overview` string
- `steps` boolean
- `language` string
- `voice_instructions` boolean
- `banner_instructions` boolean
- `exclude` string
- `depart_at` string
- `approaches` string

## Response `200`

Mapbox Directions response: `code`, `routes` (each with `weight_name: "duration"`), `waypoints` and `uuid` (the request id). `NoRoute` and `NoSegment` also answer 200 with that `code` and empty `routes`, as Mapbox documents

- object

## Other responses

- `400`: `{code, message}`: `InvalidQuery` or `InvalidValue`, including any Mapbox option MapMap does not honour (the message names the supported set). Not billed
- `401`: Missing or invalid key
- `403`: A browser (`maps`) key: routing needs a full key
- `404`: `ProfileNotFound`
- `429`: Quota or rate limit exceeded

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)