API Reference
How to make requests against Distance API v2 endpoints
Authentication
Follow the getting-started guide how to setup your developer account and get your API credentials.
Headers
X-Billing-Token
<your API key>
OpenAPI definition
Status codes
200
Valid request and all locations or waypoints could be geocoded.
400
Invalid request with information about validation.
404
Valid request but not all locations or waypoints could be geocoded.
429
Load balancer rejected the request because too many request in parallel or your usage limits exceeded.
Units
All distances are given in kilometers. To convert distances into miles, they must be multiplied by 0.621371. Maritime distances are also given in nautical miles.
The travel duration for car routing is given in seconds. For maritime routes, which are given in hours duration is calculated with a speed of 20 knots. 20 knots = 20 NM / hour.
Last updated