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

Name	Value
X-Billing-Token	<your API key>

OpenAPI definition

https://raw.githubusercontent.com/StephanGeorg/distance.tools-public-docs/main/api/openapi.yamlraw.githubusercontent.com

Status codes

Code	Description
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.