---
title: "Mapbox-compatible Matrix (see module docs)."
method: GET
path: "/directions-matrix/v1/{user}/{profile}/{coordinates}"
tags: ["mapbox-compat"]
---

# Mapbox-compatible Matrix (see module docs).

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

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/directions-matrix/v1/{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
- `sources` string
- `destinations` string
- `annotations` string
- `depart_at` string

## Response `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

- object

## Other responses

- `400`: `{code, message}` for a malformed or unsupported option, not billed
- `401`: Missing or invalid key
- `404`: `ProfileNotFound`
- `422`: More than 10,000 elements, or a span beyond the engine's matrix distance
- `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)