OSRM Directions API
Turn-by-turn navigation with a clean, easy-to-render instruction list for car, bike and foot.
/api/1/directionsCurrent plan limits
Free includes Routing, Route Optimization, Geocoding (including reverse lookup and autocomplete) and Matrix APIs within plan limits. Map Matching, Isochrone, Truck Routing, Fuel Estimate and other separate APIs require a paid plan, including PAYG. API access follows the account’s effective plan; a positive balance alone does not override Free restrictions. Road Data and AI retain their separate Business requirements.
Credit and requests-per-minute limits are shared across all account keys. An additional key credit cap cannot enlarge the account budget. Included credits are used first, then purchased credits.
Current plans and pricingOverview
The Directions API returns turn-by-turn navigation between two or more waypoints. Each step comes with human-readable text, distance, duration, maneuver type and the exact location — ready to render in a navigation UI. It supports driving, cycling and walking, plus alternative routes in one call.
API reference
/api/1/directions| Parameter | Type | Status |
|---|---|---|
| point | string | Required |
| profile | string | Optional |
| alternatives | integer | Optional |
| lang | string | Optional |
Example request
Credit cost: 1 credit per started block of 10 input points, including origin and destination.curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"