Mapbox Directions API

Best for: Prototypes and side projects - free to start, no sales call; Regulated or enterprise workloads - compliance attestations and an enterprise plan; AI agents and automation - an agent-ready surface (MCP / llms.txt)

• █████▒░░░░
  55 / 100
  Agent friendliness
• ██████████
  100 / 100
  Pricing transparency
• ████████▒░
  85 / 100
  Setup speed
• ████▒░░░░░
  45 / 100
  Docs quality
• ██████████
  100 / 100
  Procurement ease
• ██████░░░░
  60 / 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 model

Usage-based [2]mapbox.com/pricing“Mapbox offers a pay-as-you-go model with meaningful free tiers and volume discounts.”

Published pricing

✓ Yes [3]mapbox.com/pricing“100,001-500,000 requests: $2.00 per 1,000; 500,001-1,000,000 requests: $1.60 per 1,000; 1,000,001+: $1.20 per 1,000; 5,000,000+: Contact sales for discount”

Free tier

✓ Yes [4]mapbox.com/pricing“Sign up and start building with meaningful free tiers for most products.”mapbox.com/pricing“Directions API: Up to 100,000 requests/month: Free”

Free tier details

Up to 100,000 requests/month free for the Directions API. Recurring monthly allowance with no expiry.

Self-serve signup

✓ Yes

Requires sales call

✗ No

Enterprise plan

✓ Yes

• Traffic-aware

Supported actions

directions, route, eta [5]docs.mapbox.com/api/navigation/“Directions – getting directions or building navigation experiences”docs.mapbox.com/api/navigation/directions/“GET/POST https://api.mapbox.com/directions/v5/{profile}/{coordinates}”

Regions

Global road network coverage; driving-traffic profile availability varies by country/region; traffic data limited to supported geographies; inter-continental routes and routes through water bodies not supported; EV routing covers 40+ countries including US, Canada, EU, UK, Australia, New Zealand, Japan; profiles: car (mapbox/driving, mapbox/driving-traffic), bicycle (mapbox/cycling), foot/pedestrian (mapbox/walking); live and historical traffic via driving-traffic profile; predictive routing via depart_at/arrive_by parameters

Languages

Arabic, Bengali, Burmese, Chinese (Mandarin), Czech, Danish, English, Esperanto, Finnish, French, Galician, German, Hebrew, Hungarian, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Romanian, Russian, Slovenian, Spanish, Swedish, Turkish, Ukrainian, Vietnamese, Yoruba

Input types

origin/destination coordinates, waypoints (up to 25; up to 12 for EV routing with automatic charging stops), routing profile (driving/driving-traffic/walking/cycling), departure time (depart_at), arrival time (arrive_by), avoid options (motorway/toll/ferry/unpaved/country_border/tunnel), vehicle dimensions (max_height/max_width/max_weight), language preference, EV parameters (battery capacity, connector type), bearing constraints, walking speed/walkway bias, alley bias

Output types

route geometry/polyline (GeoJSON LineString, Polyline 5-decimal, Polyline6 6-decimal), distance, duration, turn-by-turn steps, banner instructions, voice instructions (SSML format), lane guidance, traffic congestion annotations, speed annotations, closure annotations, maxspeed annotations (beta), alternative routes (up to 2), administrative boundary data (ISO 3166-1), incident reports, toll collection metadata, timezone information at waypoints, EV state-of-charge annotations, JSON

Webhooks

✗ No [6]docs.mapbox.com/api/navigation/optimization/“The Optimization API v2 uses polling (GET endpoint with submission ID) — not webhooks — to retrieve results.”docs.mapbox.com/api/navigation/directions/“No mention of webhooks or asynchronous callbacks in the Directions API documentation.”

Sandbox / test mode

✗ No [7]mapbox.com/pricing“Sign up and start building with meaningful free tiers for most products.”

SDK languages

Swift/iOS/macOS, Java/Android, JavaScript [8]docs.mapbox.com/api/navigation/directions/“Swift (Mapbox Directions for Swift), Java (Mapbox Java SDK), JavaScript (Mapbox JavaScript SDK), Ruby (Mapbox Ruby SDK)”

MCP server

✓ Yes [9]docs.mapbox.com/api/guides/mcp-server/“MCP Server | API Docs | Mapbox”mapbox.com/blog/introducing-the-mapbox-model-context-protocol-mcp-server“the MCP Server simplifies the process by exposing a suite of geospatial capabilities that AI systems can call directly”

SOC 2

SOC 2 Type II [10]mapbox.com/legal/legal-faq“Mapbox is SOC2 Type 2 certified”mapbox.com/security“SOC 2 Type II – Security, Availability, and Confidentiality Report”

HIPAA

✗ No [11]mapbox.com/legal/dpa“No mention of HIPAA in the DPA; focuses on GDPR, CCPA, PIPEDA and other consumer privacy frameworks.”mapbox.com/legal/legal-faq“No mention of HIPAA compliance in the legal FAQ or security documentation.”

GDPR

✓ Yes [12]mapbox.com/legal/dpa“Mapbox operates a global data protection program designed to operate in compliance with applicable global privacy laws, including...GDPR (Europe)”mapbox.com/legal/privacy“Mapbox ensures that the transfer of personal data offers an adequate level of protection and security...by entering into the appropriate agreements including EU-US Data Privacy Framework certification and standard contractual clauses.”

ISO 27001

✗ No [13]mapbox.com/legal/legal-faq“Trusted Information Security Assessment Exchange ('TISAX') and ISO 9001 certifications”mapbox.com/security“ISO 9001 – Global Quality Standard; TISAX – Automotive Industry Standard”

PCI DSS

✗ No

Published SLA

✓ Yes [14]mapbox.com/legal/sla“99.9% of the time every month. An API will be considered unavailable when it is inaccessible during two or more consecutive 90-second intervals.”mapbox.com/legal/sla“If Customer has an active executed order, and the Mapbox APIs covered by and used in accordance with such order are not available 99.9% of the time every month”

Rate limits

Directions API: 300 requests/minute. Matrix API (standard profiles driving/walking/cycling): 60 requests/minute; Matrix API (driving-traffic): 30 requests/minute. Isochrone API: 300 requests/minute. Map Matching API: 300 requests/minute. Optimization API v2: 300 routing problems/minute, 60 list submissions/minute, 60 status requests/minute. [15]docs.mapbox.com/api/navigation/directions/“The Directions API has a maximum of 300 requests per minute. Requests that contain multiple coordinates are counted as 1 request.”docs.mapbox.com/api/navigation/map-matching/“The Map Matching API is limited to 300 requests per minute.”docs.mapbox.com/api/navigation/matrix/“Standard profiles (driving, walking, cycling): Maximum 60 requests per minute... Traffic profile: Maximum 30 requests per minute”

Known restrictions

Directions API supports up to 25 waypoints per request; EV routing requests limited to 12 total waypoints when ev_add_charging_stops=true, Inter-continental routes and routes through water bodies are not supported, Traffic coverage for driving-traffic profile limited to supported geographies; reverts to driving profile outside coverage, Attribution required: proprietary notices and product identification labels must not be removed, IP addresses retained in CloudFront logs for 30 days for billing/usage reporting, Results of the Isochrone API and Map Matching API (separate Mapbox APIs) must be displayed on a Mapbox map using one of the Mapbox libraries or SDKs, GET request URL size limited to approximately 8100 bytes; use POST for longer coordinate lists [16]docs.mapbox.com/api/navigation/directions/“Standard routes: 2-25 coordinates... EV routing requests can specify up to 12 total waypoints. If ev_add_charging_stops is false, EV routing requests can specify up to 25 total waypoints”docs.mapbox.com/api/navigation/isochrone/“Results must be displayed on a Mapbox map using one of the Mapbox libraries or SDKs.”docs.mapbox.com/api/navigation/map-matching/“Results must be displayed on a Mapbox map using one of the Mapbox libraries or SDKs.”

• Docs
• API reference
• llms.txt

Docs rendering: static · llms.txt present

API style

rest

Base URL

https://api.mapbox.com/directions/v5

Version

v5

Versioning

url

Stability

ga

Auth methods

api_key

Idempotency keys

✗ No

Error format

vendor-specific (JSON with "code" field; success = "Ok")

Rate limit

300 / minute

SDKs

• Swift/iOS/macOS MapboxDirections · repo
• Java/Android mapbox-java (services-directions module) · repo
• JavaScript mapbox-gl-directions · repo

• Auth docs
• Quickstart
• MCP server
• Deprecation policy

Launched

2010-01-01

Notable customers

AccuWeather, DoorDash, Booking.com, Skyscanner, Instacart, Adobe, BMW, Yahoo Japan, Rever

• 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

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

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

1. ↑Description: mapbox.com · docs.mapbox.com
2. ↑Pricing model: mapbox.com
3. ↑Published pricing: mapbox.com
4. ↑Free tier: mapbox.com · mapbox.com
5. ↑Supported actions: docs.mapbox.com · docs.mapbox.com
6. ↑Webhooks: docs.mapbox.com · docs.mapbox.com
7. ↑Sandbox: mapbox.com
8. ↑SDK languages: docs.mapbox.com
9. ↑MCP server: docs.mapbox.com · mapbox.com
10. ↑SOC 2: mapbox.com · mapbox.com
11. ↑HIPAA: mapbox.com · mapbox.com
12. ↑GDPR: mapbox.com · mapbox.com
13. ↑ISO 27001: mapbox.com · mapbox.com
14. ↑Published SLA: mapbox.com · mapbox.com
15. ↑Rate limits: docs.mapbox.com · docs.mapbox.com · docs.mapbox.com
16. ↑Known restrictions: docs.mapbox.com · docs.mapbox.com · docs.mapbox.com

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

1. 2026-06-15 Score Docs Quality: 10 → 45
2. 2026-06-15 Score Agent Friendliness: 45 → 55
3. 2026-06-14 API Reference URL: (none) → https://docs.mapbox.com/api/
4. 2026-06-14 Docs URL: (none) → https://docs.mapbox.com/api/
5. 2026-06-14 Has Structured Data: (none) → No
6. 2026-06-14 Robots Allows Agents: (none) → Yes
7. 2026-06-14 Capabilities: {} → {"traffic":true}
8. 2026-06-14 Summary Md: (none) → Mapbox Directions API is a REST routing service covering a global road network,…
9. 2026-06-14 Best For: (none) → Prototypes and side projects - free to start, no sales call, Regulated or enter…
10. 2026-06-14 Score Agent Friendliness: (none) → 45
11. 2026-06-14 Score Pricing Transparency: (none) → 100
12. 2026-06-14 Score Setup Speed: (none) → 85
13. 2026-06-14 Score Docs Quality: (none) → 10
14. 2026-06-14 Score Procurement Friction: (none) → 100
15. 2026-06-14 Score Trust Readiness: (none) → 60
16. 2026-06-14 Scoring Methodology: (none) → Scores are computed deterministically from this profile's published, sourced fi…
17. 2026-06-14 Llms Txt Present: (none) → Yes
18. 2026-06-14 Rendering: (none) → static
19. 2026-06-14 Llms Txt URL: (none) → https://docs.mapbox.com/llms.txt
20. 2026-06-14 Free Tier Details: set to Up to 100,000 requests/month free for the Directions API. Recurring monthly all…
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 SOC 2: set to type_2
25. 2026-06-14 HIPAA: set to No
26. 2026-06-14 GDPR: set to Yes
27. 2026-06-14 ISO 27001: set to No
28. 2026-06-14 PCI DSS: set to No
29. 2026-06-14 SLA Published: set to Yes
30. 2026-06-14 SLA URL: set to https://www.mapbox.com/legal/sla
31. 2026-06-14 Data Retention Policy URL: set to https://www.mapbox.com/legal/dpa
32. 2026-06-14 Documented Rate Limits: set to Directions API: 300 requests/minute. Matrix API (standard profiles driving/walk…
33. 2026-06-14 Rate Limit Requests: set to 300
34. 2026-06-14 Rate Limit Window: set to minute
35. 2026-06-14 Known Restrictions: set to Directions API supports up to 25 waypoints per request; EV routing requests lim…
36. 2026-06-14 Auth Methods: set to api_key
37. 2026-06-14 Auth Docs URL: set to https://docs.mapbox.com/accounts/guides/tokens/
38. 2026-06-14 API Style: set to rest
39. 2026-06-14 Base URL: set to https://api.mapbox.com/directions/v5
40. 2026-06-14 API Version: set to v5
41. 2026-06-14 Versioning Scheme: set to url
42. 2026-06-14 Stability: set to ga
43. 2026-06-14 Deprecation Policy URL: set to https://docs.mapbox.com/api/guides/
44. 2026-06-14 MCP URL: set to https://mcp.mapbox.com/mcp
45. 2026-06-14 Quickstart URL: set to https://docs.mapbox.com/help/tutorials/getting-started-directions-api/
46. 2026-06-14 Idempotency Supported: set to No
47. 2026-06-14 Error Format: set to vendor-specific (JSON with "code" field; success = "Ok")
48. 2026-06-14 Slug: set to mapbox-directions
49. 2026-06-14 Starting Price Usd: set to 2
50. 2026-06-14 Price Basis: set to 1,000 requests

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.

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

curl -X POST https://apio.sh/api/suggest/mapbox-directions/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 →