---
title: "OSRM-compatible route endpoint (see module docs)."
method: GET
path: "/route/v1/{profile}/{coordinates}"
tags: ["routing"]
---

# OSRM-compatible route endpoint (see module docs).

`GET /route/v1/{profile}/{coordinates}`

## Request

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

## Path parameters

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

## Query parameters

- `alternatives` string
- `steps` boolean
- `annotations` string
- `geometries` string
- `overview` string
- `avoid_tolls` boolean
- `avoid_motorways` boolean
- `avoid_ferries` boolean
- `avoid` string
- `exclude` string
- `shortest` boolean
- `voice_instructions` boolean
- `banner_instructions` boolean
- `landmarks` boolean
- `language` string
- `height` number, double
- `width` number, double
- `length` number, double
- `weight` number, double
- `hazmat` boolean
- `tunnel_code` string
- `use_lit` number, double
- `pedestrian_type` string
- `max_hiking_difficulty` integer
- `bicycle_type` string
- `use_roads` number, double
- `use_living_streets` number, double
- `avoid_bad_surfaces` number, double
- `use_hills` number, double
- `depart_at` string
- `arrive_by` string
- `speed_types` string
- `approaches` string
- `street_side_tolerance` integer
- `street_side_max_distance` integer
- `street_side_cutoff` string
- `exclude_polygons` string
- `exclude_locations` string
- `safety_alerts` boolean
- `safety_alerts_enforcement` string

## Response `200`

OSRM route response (`code: Ok`)

- object

## Other responses

- `400`: OSRM error envelope, e.g. `InvalidQuery`, `InvalidValue`, `NoSegment`, `NoRoute`
- `401`: Missing or invalid API key
- `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)