---
title: "Report endpoint (see module docs)."
method: POST
path: "/route/report"
tags: ["routing"]
---

# Report endpoint (see module docs).

`POST /route/report`

## Request

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

## Request body

- object

## Response `200`

`{distance_m, duration_s, by_road_class: {<class>: {distance_m, duration_s, edge_count}}, by_admin: [{country_code, country_text, state_code, state_text, distance_m, duration_s, edge_count}], toll: {edge_count, distance_m}, bridge: {…}, tunnel: {…}, by_surface: {<surface>: {distance_m, edge_count}}, edge_count}`. Distances in metres, durations in seconds. An edge with no resolvable admin area is grouped under a null-keyed entry in `by_admin`, never guessed at

- object

## Other responses

- `400`: Invalid request, or neither/both of `locations` and a trace given
- `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)