WayMatrixWayMatrix
WayMatrix
  • Getting started
  • API reference
  • Your API keys
  • Your usage
  • Billing
  • Back to waymatrix.io
Information
Matrix
    Travel-time and distance matrixpostTravel-time and distance matrix (explicit JSON form)post
Directions
    Route between two pointsgetRoute with full optionspostRoute, JSON formpostRoute, GeoJSON formpostRoute, GPX formpost
Isochrones
    Reachability polygonspostReachability polygons (explicit GeoJSON form)post
Service
    LivenessgetLiveness, headers onlyheadEngine and graph provenancegetEngine and graph provenance, headers onlyhead
Schemas
powered by Zuplo
WayMatrix Routing API
WayMatrix Routing API

Service

Health checks and data versions. No key needed, and never charged.


Liveness

GET
https://api.waymatrix.io
/v2/health

Whether routing is up and ready for requests. It needs no key and is never charged.

Liveness › Responses

The engine is ready.

status
​string
GET/v2/health
curl https://api.waymatrix.io/v2/health
Example Responses
{ "status": "ready" }
json
application/json

Liveness, headers only

HEAD
https://api.waymatrix.io
/v2/health

Identical to GET /v2/health without a body, for uptime monitors that send HEAD.

Liveness, headers only › Responses

The engine is ready.

No data returned
HEAD/v2/health
curl https://api.waymatrix.io/v2/health \ --request HEAD
Example Responses
No example specified for this content type

Engine and graph provenance

GET
https://api.waymatrix.io
/v2/status

Shows which version of the routing software is running, when the road graph was built, and the date of the OpenStreetMap data it was built from.

Reading the response

The services field is the routing software's own list of what it can do, passed through unchanged, so it names more than this API serves. snap, export and match appear in it but return 404 here, and export is never available.

To see what you can call, use profiles in this response and the endpoints in this reference.

Engine and graph provenance › Responses

Engine, graph and profile information.

GET/v2/status
curl https://api.waymatrix.io/v2/status
Example Responses
{ "engine": { "version": "9.10.0", "build_date": "2026-07-28T16:17:35Z", "graph_version": "5", "graph_date": "2026-07-31T20:07:53Z", "osm_date": "2026-07-30T20:21:02Z" }, "profiles": [ "driving-car" ], "services": [ "routing", "isochrones", "matrix", "snap", "export", "match" ] }
json
application/json

Engine and graph provenance, headers only

HEAD
https://api.waymatrix.io
/v2/status

Identical to GET /v2/status without a body.

Engine and graph provenance, headers only › Responses

Engine, graph and profile information.

No data returned
HEAD/v2/status
curl https://api.waymatrix.io/v2/status \ --request HEAD
Example Responses
No example specified for this content type

Isochrones