---
title: "Map matching to a route (see module docs)."
method: POST
path: "/trace_route"
tags: ["routing"]
---

# Map matching to a route (see module docs).

`POST /trace_route`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/trace_route`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Request body

- object

## Response `200`

Valhalla route response for the matched trace

- object

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `429`: Quota or rate limit exceeded
- `502`: Upstream routing engine failed

---

[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)