GraphHopper Directions API


With the GraphHopper Directions API you can integrate A-to-B route planning, turn-by-turn navigation, route optimization, isochrone calculations and other tools in your application.

The GraphHopper Directions API consists of the following RESTful web services:

Explore our APIs

Get started

  1. Sign up for GraphHopper
  2. Create an API key

Each API part has its own documentation. Jump to the desired API part and learn about the API through the given examples and tutorials.

In addition, for each API there are specific sample requests that you can send via Insomnia or Postman to see what the requests and responses look like.


To explore our APIs with Insomnia, follow these steps:

  1. Open Insomnia and Import our workspace.
  2. Specify your API key in your workspace: Manage Environments -> Base Environment -> "api_key": your API key
  3. Start exploring



To explore our APIs with Postman, follow these steps:

  1. Import our request collections as well as our environment file.
  2. Specify your API key in your environment: "api_key": your API key
  3. Start exploring


API Client Libraries

To speed up development and make coding easier, we offer the following client libraries:

Bandwidth reduction

If you create your own client, make sure it supports http/2 and gzipped responses for best speed.

If you use the Matrix, the Route Optimization API or the Cluster API and want to solve large problems, we recommend you to reduce bandwidth by compressing your POST request and specifying the header as follows: Content-Encoding: gzip. This will also avoid the HTTP 413 error “Request Entity Too Large”.

Contact Us

If you have problems or questions, please read the following information:

To stay informed about the latest developments, you can

Select the channel you like the most.

Map Data and Routing Profiles

Currently, our main data source is OpenStreetMap. We also integrated other network data providers. This chapter gives an overview about the options you have.


Geographical Coverage

OpenStreetMap covers the whole world. If you want to see for yourself if we can provide data suitable for your region, please visit GraphHopper Maps. You can edit and modify OpenStreetMap data if you find that important information is missing, e.g. a weight limit for a bridge. Here is a beginner’s guide that shows how to add data. If you have edited data, we usually consider your data after 1 week at the latest.

Supported Vehicle Profiles

The Routing, Matrix and Route Optimization APIs support the following vehicle profiles:

carCar modecar accesscar image
small_truckSmall truck like a Mercedes Sprinter, Ford Transit or Iveco Dailyheight=2.7m, width=2+0.4m, length=5.5m, weight=2080+1400 kgsmall truck image
truckTruck like a MAN or Mercedes-Benz Actrosheight=3.7m, width=2.6+0.5m, length=12m, weight=13000 + 13000 kg, hgv=yes, 3 Axestruck image
scooterMoped modeFast inner city, often used for food delivery, is able to ignore certain bollards, maximum speed of roughly 50km/hscooter image
footPedestrian or walking without dangerous SAC-scalesfoot accessfoot image
hikePedestrian or walking with priority for more beautiful hiking tours and potentially a bit longer than foot. Walking duration is influenced by elevation differences.foot accesshike image
bikeTrekking bike avoiding hillsbike accessbike image
mtbMountainbikebike accessMountainbike image
racingbikeBike preferring roadsbike accessracingbike image

Please note:

  • all motor vehicles (car, small_truck, truck and scooter) support turn restrictions via turn_costs=true
  • the free package supports only the vehicle profiles car, bike or foot
  • up to 2 different vehicle profiles can be used in a single optimization request. The number of vehicles is unaffected and depends on your subscription.
  • we offer custom vehicle profiles with different properties, different speed profiles or different access options. To find out more about custom profiles, please contact us.
  • a sophisticated motorcycle profile is available up on request. It is powered by the Kurviger Routing API and favors curves and slopes while avoiding cities and highways.


If you want to include traffic, you can purchase the TomTom Add-on. This Add-on only uses TomTom’s road network and historical traffic information. Live traffic is not yet considered. If you are interested to learn how we consider traffic information, we recommend that you read this article.

Please note the following:

Contact us for more details.

Geographical Coverage

We offer

  • Europe including Russia
  • North, Central and South America
  • Saudi Arabia
  • United Arab Emirates
  • South Africa
  • Australia

Supported Vehicle Profiles

carCar modecar accesscar image
small_truckSmall truck like a Mercedes Sprinter, Ford Transit or Iveco Dailyheight=2.7m, width=2+0.4m, length=5.5m, weight=2080+1400 kgsmall truck image

Use this page to mock GraphHopper Directions API in your testing and development.

Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of GraphHopper Directions API, which will allow you to keep building and testing even if the actual API you isn't currently available.

Related mocks

IP2Location IP Geolocation

IP2Location web service providing a

Georg API


API for OpenAQ LCS

Geomag API

The World Magnetic Model calculates the

Dados Abertos - API

API de Dados Abertos com dados

Daymet Single Pixel Extraction Tool API

Welcome to the Daymet Single Pixel

Ready to accelerate your development flow

Shorter release cycles, more predictable schedules and fewer defects in production.
Start Mocking for Free *Free forever. No credit card needed