GraphHopper Directions API

"Route Planning For Your Application" [1]

www.graphhopper.com/ · By GraphHopper · Agent JSON · Suggest an edit · Last verified 2026-06-14 · Source confidence: high

GraphHopper Directions API is a routing and logistics platform built for developers who need turn-by-turn navigation, delivery optimization, isochrone analysis, map matching, and geocoding over worldwide OpenStreetMap coverage supplemented by TomTom data in 150+ countries. It offers self-serve subscription plans with published pricing, a free tier capped at 500 credits per day for non-commercial use, and an enterprise option backed by a published SLA. The REST API uses API key authentication and ships official SDKs for JavaScript and Java, with customers including GLS, DB Systel, and Posten.

Best for / Avoid if

Best for: Prototypes and side projects - free to start, no sales call; Teams needing broad API coverage out of the box

Avoid if: You have strict compliance requirements

Scores

  • 30 / 100
    Agent friendliness
  • 75 / 100
    Pricing transparency
  • 80 / 100
    Setup speed
  • 35 / 100
    Docs quality
  • 90 / 100
    Procurement ease
  • 35 / 100
    Trust readiness

Scores are computed deterministically from this profile's published, sourced fields (pricing, compliance, capabilities, docs and developer-surface signals) - not from reviews or paid placement. Each axis is 0-100; an unknown signal scores 0 for that axis. Procurement ease is the inverse of buying friction (higher = easier to adopt).

Pricing & procurement

Pricing model
Subscription [2]
Published pricing
Yes [3]
Free tier
Yes [4]
Free tier details
Free plan at €0/month with 500 daily credits, max 5 locations per request, max 1 vehicle. Non-commercial use only (commercial allowed during development phase; production requires inquiry). Forum support only, no rate limit guarantees. [5]
Self-serve signup
Yes [6]
Requires sales call
No
Enterprise plan
Yes [7]
Published prices
PlanItemPerAmountSource
Freemonthly subscription — 500 daily credits, max 5 locations, max 1 vehiclemonth$0source
Basicmonthly subscription — 5,000 daily credits, max 30 locations, max 2 vehiclesmonth$79.83source
Standardmonthly subscription — 15,000 daily credits, max 80 locations, max 10 vehiclesmonth$230.24source
Premiummonthly subscription — 50,000 daily credits, max 200 locations, max 20 vehiclesmonth$555.08source
Custom / Enterprisemonthly subscription — custom daily credits, up to 10,000 locations, up to 200 vehiclesmonth - source
All paid plansattribution (co-branding) discount — 20% off plan price when showing GraphHopper attributionmonth20%source
All plansRouting API request (2–10 locations, standard)1 credit per request - source
All plansRouting API request (>10 locations)num_locations / 10 credits per request - source
All plansRouting API request with alternative routes (2–10 locations)2 credits per request - source
All plansRouting API round-trip request2 credits per request - source
All plansRouting API TSP optimization (optimize=true, 2–10 locations)10 credits per request - source
All plansMatrix API requestmin(origins*destinations/2, max(origins,destinations)*10) credits per request - source
All plansRoute Optimization API job (VRP)vehicles * locations credits per job (min 10, max 10*locations) - source
All plansRoute Optimization API — GET solution fetch0.3 credits per request - source
All plansGeocoding API request (default/Gisgraphy provider)0.3 credits per request - source
All plansGeocoding API request (Nominatim/NetToolkit/OpenCageData provider)0.9 credits per request - source
All plansMap Matching API requestinput_locations / 50 credits per request (min 1) - source
All plansIsochrone API request2 credits per minute explored (min 10) per request - source
All plansCluster API request (standard profile)10 credits per customer (min 10) per request - source
All plansCluster API request (as-the-crow-flies profile)1 credit per customer (min 1) per request - source

Capabilities

  • Distance matrix
  • Route optimization
  • Isochrones
  • Traffic-aware
  • Truck / HGV routing
  • Transit / multimodal
  • Map matching
Supported actions
directions, route, distance_matrix, route_optimization, vehicle_routing, isochrone, map_matching, geocoding, reverse_geocoding, clustering, custom_profiles, waypoint_optimization [8]
Regions
Worldwide coverage via OpenStreetMap, TomTom MultiNet: 150+ countries and 30 territories, Travel modes: car, truck, bike (including cargo bike), foot, scooter, motorcycle, Custom vehicle profiles supported, Historical traffic (TomTom) - live traffic not supported, Public transit routing via OSM and GTFS data [9]
Languages
49 languages supported for turn-by-turn instructions (locale parameter, e.g. de, pt_PT, pt_BR)
Input types
origin/destination coordinates (lat/lng pairs), waypoints (multiple points), addresses (for geocoding), GPS tracks (GPX files for map matching), vehicle profiles (car, truck, bike, foot, scooter, custom), time windows (Unix timestamps), vehicle capacity and skills constraints, custom model JSON for routing customization, departure time for time-dependent routing
Output types
route geometry/polyline, distance, duration, turn-by-turn instructions, elevation, GeoJSON, JSON, matrix of travel times and distances, isochrone polygon, optimization solution with stop assignments, clustering solution, map-matched GPS trace
Webhooks
No
Sandbox / test mode
No [10]
SDK languages
JavaScript, Java [11]
MCP server
No [12]

Trust & compliance

SOC 2
Unknown [13]
HIPAA
No [14]
GDPR
Yes [15]
ISO 27001
Unknown
PCI DSS
No [16]
Published SLA
Yes [17]
Rate limits
Free: no guarantee; Basic: 1 req/s, 100 credits/min; Standard: 2 req/s, 400 credits/min; Premium: 10 req/s, 1,000 credits/min [18]
Known restrictions
Free tier is non-commercial use only (commercial use in development phase tolerated; production commercial use requires inquiry), Free tier limited to 1 vehicle and 5 locations per request, Attribution required: 'Powered by GraphHopper API' link on all free-plan apps and non-white-label paid plans, OpenStreetMap attribution always required regardless of plan, Mass downloading and scraping prohibited unless package explicitly permits, Temporary client-side caching permitted; no persistent storage of routes, Free tier disables flexible mode (ch.disable=true) and restricts vehicle profiles, Only one free package per user, TomTom Add-on uses historical traffic only - live traffic not supported, Custom profiles geographic coverage is restricted, Max locations per request: 5 (Free), 30 (Basic), 80 (Standard), 200 (Premium), up to 10,000 (Custom), Max vehicles: 1 (Free), 2 (Basic), 10 (Standard), 20 (Premium), up to 200 (Custom) [19]

Developer surface

Docs rendering: static

Integration

API style
rest
Base URL
https://graphhopper.com/api/1
Version
1.0.0
Versioning
url
Stability
ga
Auth methods
api_key
Idempotency keys
No
Error format
vendor-specific JSON ({message, hints[]})

SDKs

  • JavaScript @graphhopper/directions-api-js-client · repo
  • Java · repo

Adoption & maturity

Launched
2012-01-01
GA
2020-05-25
Notable customers
GLS, DB Systel, Bumbal, Posten, Nordsense, Washmen

Other Routing APIs

  • Azure Maps Route

    "Use to get the best route between an origin and destination for automobile, commercial trucks and walking routes."

    Usage · free tier · public pricing · self-serve

  • Route4Me

    "Industrial Grade Route Planning And Route Optimization Software" that "automates and integrates mission-critical last mile workflows, empowering route planners, dispatchers, drivers, and managers to take your business to the next level."

    Subscription · free tier · public pricing · self-serve

  • HERE Routing API

    "Plan stress-free journeys" with routing solutions "for various modes of transport" enabling last-mile delivery, fleet management, and freight logistics.

    Hybrid · free tier · public pricing · self-serve

  • Radar Geocoding API

    "Use Radar's geocoding APIs to convert addresses to latitude and longitude coordinates, or vice versa."

    Hybrid · free tier · public pricing · self-serve

  • Routific

    "Delivery management for growing businesses"

    Subscription · free tier · public pricing · self-serve

  • Google Routes API

    "Compute Routes returns the ideal route between two locations, and Compute Route Matrix returns distances and travel times for a matrix of routes between different origin and destination locations."

    Usage · free tier · public pricing · self-serve

GraphHopper Directions API alternatives · GraphHopper Directions API vs Azure Maps Route · All Routing APIs APIs

References

Each field above carries a numbered source - hover for a preview, click to jump here.

  1. Description: graphhopper.com
  2. Pricing model: support.graphhopper.com · graphhopper.com
  3. Published pricing: graphhopper.com
  4. Free tier: graphhopper.com · graphhopper.com
  5. Free tier details: graphhopper.com · graphhopper.com
  6. Self-serve signup: graphhopper.com
  7. Enterprise plan: graphhopper.com · support.graphhopper.com
  8. Supported actions: graphhopper.com · docs.graphhopper.com
  9. Regions: graphhopper.com · docs.graphhopper.com
  10. Sandbox: docs.graphhopper.com
  11. SDK languages: github.com · github.com
  12. MCP server: composio.dev
  13. SOC 2: graphhopper.com
  14. HIPAA: graphhopper.com · graphhopper.com
  15. GDPR: graphhopper.com · graphhopper.com
  16. PCI DSS: graphhopper.com
  17. Published SLA: graphhopper.com · graphhopper.com
  18. Rate limits: graphhopper.com
  19. Known restrictions: graphhopper.com · graphhopper.com · support.graphhopper.com

Change history

Every field change, who made it, and when - from our audited data pipeline and editors.

  1. 2026-06-15 Score Agent Friendliness: 1030
  2. 2026-06-15 Score Docs Quality: 1535
  3. 2026-06-14 Has Structured Data: (none)Yes
  4. 2026-06-14 API Reference URL: (none)https://docs.graphhopper.com/
  5. 2026-06-14 Robots Allows Agents: (none)Yes
  6. 2026-06-14 Capabilities: {}{"truck":true,"traffic":true,"transit":true,"isochrones":true,"map_matching":tr…
  7. 2026-06-14 Summary Md: (none)GraphHopper Directions API is a routing and logistics platform built for develo…
  8. 2026-06-14 Avoid If: (none)You have strict compliance requirements
  9. 2026-06-14 Scoring Methodology: (none)Scores are computed deterministically from this profile's published, sourced fi…
  10. 2026-06-14 Best For: (none)Prototypes and side projects - free to start, no sales call, Teams needing broa…
  11. 2026-06-14 Score Agent Friendliness: (none)10
  12. 2026-06-14 Score Pricing Transparency: (none)75
  13. 2026-06-14 Score Setup Speed: (none)80
  14. 2026-06-14 Score Docs Quality: (none)15
  15. 2026-06-14 Score Procurement Friction: (none)90
  16. 2026-06-14 Score Trust Readiness: (none)35
  17. 2026-06-14 Llms Txt Present: (none)No
  18. 2026-06-14 Docs URL: (none)https://www.graphhopper.com/docs
  19. 2026-06-14 Status Page URL: (none)https://status.graphhopper.com
  20. 2026-06-14 Rendering: (none)static
  21. 2026-06-14 Self Serve Signup: set to Yes
  22. 2026-06-14 Requires Sales Call: set to No
  23. 2026-06-14 Enterprise Plan Available: set to Yes
  24. 2026-06-14 HIPAA: set to No
  25. 2026-06-14 GDPR: set to Yes
  26. 2026-06-14 PCI DSS: set to No
  27. 2026-06-14 SLA Published: set to Yes
  28. 2026-06-14 SLA URL: set to https://www.graphhopper.com/terms/
  29. 2026-06-14 Data Retention Policy URL: set to https://www.graphhopper.com/privacy/
  30. 2026-06-14 Documented Rate Limits: set to Free: no guarantee; Basic: 1 req/s, 100 credits/min; Standard: 2 req/s, 400 cre…
  31. 2026-06-14 Known Restrictions: set to Free tier is non-commercial use only (commercial use in development phase toler…
  32. 2026-06-14 Auth Methods: set to api_key
  33. 2026-06-14 Auth Docs URL: set to https://docs.graphhopper.com/openapi/section/authentication
  34. 2026-06-14 API Style: set to rest
  35. 2026-06-14 Base URL: set to https://graphhopper.com/api/1
  36. 2026-06-14 API Version: set to 1.0.0
  37. 2026-06-14 Versioning Scheme: set to url
  38. 2026-06-14 Stability: set to ga
  39. 2026-06-14 Quickstart URL: set to https://www.graphhopper.com/developers/
  40. 2026-06-14 Idempotency Supported: set to No
  41. 2026-06-14 Error Format: set to vendor-specific JSON ({message, hints[]})
  42. 2026-06-14 Requires Verification: set to No
  43. 2026-06-14 Price Basis: set to month
  44. 2026-06-14 Free Tier Limit: set to 500 credits/day, non-commercial use only
  45. 2026-06-14 Launched At: set to 2012-01-01
  46. 2026-06-14 Slug: set to graphhopper
  47. 2026-06-14 Notable Customers: set to GLS, DB Systel, Bumbal, Posten, Nordsense, Washmen
  48. 2026-06-14 Fields Not Found: set to soc2 (no mention in privacy policy, terms, or any findable trust page), iso_270…
  49. 2026-06-14 Source Confidence: set to high
  50. 2026-06-14 Extractor: set to claude-subagent:sonnet

Suggest an edit / leave a review

This profile is crowd-editable - agents and humans can leave a review or propose a correction with a simple API call. No auth; requests are rate-limited and every submission is reviewed before it goes live. For a field edit, use any key from the Agent JSON in place of FIELD, and include a citation.

Leave a review or comment

curl -X POST https://apio.sh/api/feedback/graphhopper \
  -H 'Content-Type: application/json' \
  -d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'

Suggest a correction to a field (cite a source)

curl -X POST https://apio.sh/api/suggest/graphhopper/FIELD \
  -H 'Content-Type: application/json' \
  -d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'

All the ways to contribute →