Changelog

Pay-as-you-go plan: no subscription — add a card once, top up a prepaid credit balance in whole US dollars ($1 = 1,000 credits), and every request deducts its credit cost. Top-ups are charged in the background; automatic top-up is optional.

HTTP 402 Payment Required is returned when a prepaid balance cannot cover a request. It is not transient: do not retry, top up instead. Pay-as-you-go responses also carry X-Credits-Remaining (credits left), X-Balance-Remaining (approximate USD) and X-Balance-Currency.

Balance history, top-up status and automatic top-up settings are available in the dashboard.

Pay as you go carries Starter-tier limits (100 requests/min, 30 route points, 2 vehicles, 15-minute isochrones); larger limits come with Pro and Business.

Subscribers can buy credits as overage: once the daily allowance is spent, purchased credits are used automatically instead of a 429. X-Credits-Remaining now reports the daily allowance left plus purchased credits; X-Balance-Credits reports the purchased part.

JavaScript/TypeScript SDK (@osrmroute/sdk) — zero dependencies, covers all 23 endpoints, takes [lat, lon] everywhere.

Python SDK (osrmroute) — standard library only, so it never conflicts with your existing HTTP stack.

Every API response now carries X-RateLimit-Limit / -Remaining / -Reset and X-Credits-Limit / -Remaining / -Reset, so you can self-throttle instead of discovering limits through 429s. Rejections also send Retry-After.

Reverse geocoding now accepts reverse=1 and reverse=yes, not only reverse=true. Previously those silently fell through to forward search and returned an unrelated result.

Routing, matrix, map matching and trip now cover every continent. Africa and South America completed the rollout.

Requests are dispatched to the road graph for the continent they fall in, so a route in Brazil no longer runs against the North American network.

Mainland China is deliberately excluded and returns a clear 422. OpenStreetMap coordinates there carry the mandated GCJ-02 offset (50–500 m from GPS), which would produce inaccurate routes. Hong Kong, Macau and Taiwan are unaffected.

Forward geocoding and autocomplete now cover the entire planet, not just the Caucasus and Central Asia region.

Ranking favours major places, so searching a capital city no longer returns a same-named village or a nearby bar first.

Routes with more than roughly 14 waypoints returned HTTP 500. A logging column was too small for long request paths and rejected the write.

The per-minute burst limit counted credits instead of requests, so a single large matrix call (for example 80×80) could be rejected on its own. Burst now counts requests, as documented.

Embeddable route widget — drop routing into any site with an iframe, no build step.

Geocoding results are enriched with additional place attributes and points of interest.

Full legal suite published: Terms, Privacy, Acceptable Use, Refund Policy, DPA and User Agreement.

RapidAPI-proxied traffic is accepted via the proxy-secret header.

Self-serve subscription cancellation from the dashboard, plus a past-due warning.

The OpenAPI spec carries example values for every parameter, so the interactive console and generated clients work out of the box.

Map coverage expanded from 10 to 26 countries across the Caucasus, Central Asia, Turkey, Iran and the Middle East.

Geocoding re-ranks results by category intent, so searching "pharmacy" surfaces pharmacies rather than streets with a similar name.

Per-key restrictions — lock an API key to specific websites or IP addresses to limit the damage of a leaked key.

Daily limits moved to a rolling 24-hour window. Your budget now frees up continuously instead of resetting at a fixed hour.

Per-key credit usage charts in the dashboard, with weekly and monthly views.

Places (nearby POI) API.

Bicycle and pedestrian routing run on their own dedicated road graphs rather than reusing the driving network.