{ "name": "Mapbox Directions API", "slug": "mapbox-directions", "website_url": "https://docs.mapbox.com/api/navigation/directions/", "vendor_description": "\"The Mapbox Directions API will show you how to get where you're going.\"", "categories": [ "routing" ], "summary": "Mapbox Directions API is a REST routing service covering a global road network, supporting turn-by-turn navigation, ETA prediction, fleet and delivery routing, and EV route planning with charging stops across 40-plus countries, for profiles including driving, cycling, and walking. Pricing is usage-based at $2.00 per 1,000 requests after a free tier of 100,000 requests per month, with self-serve signup and an enterprise plan available. The API offers SDKs for iOS, Android, and JavaScript, holds SOC 2 Type 2 and GDPR certifications, and publishes an SLA.", "capabilities": { "supported_actions": [ "directions", "route", "eta" ], "supported_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" ], "supported_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_supported": false, "sandbox_available": false, "sdk_languages": [ "Swift/iOS/macOS", "Java/Android", "JavaScript" ], "mcp_server_available": true }, "integration": { "api_style": "rest", "base_url": "https://api.mapbox.com/directions/v5", "api_version": "v5", "versioning_scheme": "url", "stability": "ga", "deprecation_policy_url": "https://docs.mapbox.com/api/guides/", "auth_methods": [ "api_key" ], "auth_docs_url": "https://docs.mapbox.com/accounts/guides/tokens/", "idempotency_supported": false, "error_format": "vendor-specific (JSON with \"code\" field; success = \"Ok\")", "webhook_signing": null, "webhook_events_url": null, "rate_limit_requests": 300, "rate_limit_window": "minute", "sdk_packages": [ { "package": "MapboxDirections", "language": "Swift/iOS/macOS", "official": true, "repo_url": "https://github.com/mapbox/mapbox-directions-swift" }, { "package": "mapbox-java (services-directions module)", "language": "Java/Android", "official": true, "repo_url": "https://github.com/mapbox/mapbox-java" }, { "package": "mapbox-gl-directions", "language": "JavaScript", "official": true, "repo_url": "https://github.com/mapbox/mapbox-gl-directions" } ], "mcp_url": "https://mcp.mapbox.com/mcp", "quickstart_url": "https://docs.mapbox.com/help/tutorials/getting-started-directions-api/" }, "pricing": { "pricing_model": "usage_based", "has_published_pricing": true, "starting_price_usd": "2.0000", "price_basis": "1,000 requests", "free_tier_available": true, "free_tier_limit": "100,000 requests/month", "free_tier_details": "Up to 100,000 requests/month free for the Directions API. Recurring monthly allowance with no expiry.", "minimum_commitment": null, "self_serve_signup": true, "requires_sales_call": false, "requires_verification": false, "enterprise_plan_available": true, "price_points": [ { "plan": "Free", "item": "route requests", "amount_usd": "0.0000", "amount_percent": null, "per": "100,000 requests/month", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Pay-as-you-go", "item": "route requests", "amount_usd": "2.0000", "amount_percent": null, "per": "1,000 requests (100,001–500,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Pay-as-you-go", "item": "route requests", "amount_usd": "1.6000", "amount_percent": null, "per": "1,000 requests (500,001–1,000,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Pay-as-you-go", "item": "route requests", "amount_usd": "1.2000", "amount_percent": null, "per": "1,000 requests (1,000,001–4,999,999/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Enterprise", "item": "route requests", "amount_usd": null, "amount_percent": null, "per": "1,000 requests (5,000,000+/month, contact sales for discount)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" } ] }, "compliance": { "soc2": "type_2", "hipaa": false, "gdpr": true, "iso_27001": false, "pci_dss": false, "sla_published": true, "sla_url": "https://www.mapbox.com/legal/sla", "data_retention_policy_url": "https://www.mapbox.com/legal/dpa", "documented_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.", "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" ] }, "developer": { "docs_url": "https://docs.mapbox.com/api/", "api_reference_url": "https://docs.mapbox.com/api/", "openapi_spec_url": null, "postman_collection_url": null, "changelog_url": null, "status_page_url": null, "llms_txt_url": "https://docs.mapbox.com/llms.txt", "markdown_docs_url": null, "rendering": "static" }, "adoption": { "launched_at": "2010-01-01", "ga_date": null, "github_stars": null, "github_stars_at": null, "notable_customers": [ "AccuWeather", "DoorDash", "Booking.com", "Skyscanner", "Instacart", "Adobe", "BMW", "Yahoo Japan", "Rever" ] }, "scores": { "agent_friendliness": 55, "pricing_transparency": 100, "setup_speed": 85, "docs_quality": 45, "procurement_friction": 100, "trust_readiness": 60, "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)" ], "avoid_if": [] }, "sources": [ { "field": "vendor_description", "url": "https://www.mapbox.com/pricing", "excerpt": "Calculate optimal driving, walking, and cycling routes that take traffic and incidents into account.", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.mapbox.com/api/navigation/", "excerpt": "Directions – getting directions or building navigation experiences", "confidence": "high" }, { "field": "webhooks_supported", "url": "https://docs.mapbox.com/api/navigation/optimization/", "excerpt": "The Optimization API v2 uses polling (GET endpoint with submission ID) — not webhooks — to retrieve results.", "confidence": "high" }, { "field": "free_tier_available", "url": "https://www.mapbox.com/pricing", "excerpt": "Sign up and start building with meaningful free tiers for most products.", "confidence": "high" }, { "field": "pricing_model", "url": "https://www.mapbox.com/pricing", "excerpt": "Mapbox offers a pay-as-you-go model with meaningful free tiers and volume discounts.", "confidence": "high" }, { "field": "soc2", "url": "https://www.mapbox.com/legal/legal-faq", "excerpt": "Mapbox is SOC2 Type 2 certified", "confidence": "high" }, { "field": "iso_27001", "url": "https://www.mapbox.com/legal/legal-faq", "excerpt": "Trusted Information Security Assessment Exchange ('TISAX') and ISO 9001 certifications", "confidence": "high" }, { "field": "hipaa", "url": "https://www.mapbox.com/legal/dpa", "excerpt": "No mention of HIPAA in the DPA; focuses on GDPR, CCPA, PIPEDA and other consumer privacy frameworks.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "The Directions API has a maximum of 300 requests per minute. Requests that contain multiple coordinates are counted as 1 request.", "confidence": "high" }, { "field": "vendor_description", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "The Mapbox Directions API will show you how to get where you're going.", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "GET/POST https://api.mapbox.com/directions/v5/{profile}/{coordinates}", "confidence": "high" }, { "field": "webhooks_supported", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "No mention of webhooks or asynchronous callbacks in the Directions API documentation.", "confidence": "high" }, { "field": "free_tier_available", "url": "https://www.mapbox.com/pricing", "excerpt": "Directions API: Up to 100,000 requests/month: Free", "confidence": "high" }, { "field": "has_published_pricing", "url": "https://www.mapbox.com/pricing", "excerpt": "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", "confidence": "high" }, { "field": "soc2", "url": "https://www.mapbox.com/security", "excerpt": "SOC 2 Type II – Security, Availability, and Confidentiality Report", "confidence": "high" }, { "field": "iso_27001", "url": "https://www.mapbox.com/security", "excerpt": "ISO 9001 – Global Quality Standard; TISAX – Automotive Industry Standard", "confidence": "high" }, { "field": "hipaa", "url": "https://www.mapbox.com/legal/legal-faq", "excerpt": "No mention of HIPAA compliance in the legal FAQ or security documentation.", "confidence": "high" }, { "field": "gdpr", "url": "https://www.mapbox.com/legal/dpa", "excerpt": "Mapbox operates a global data protection program designed to operate in compliance with applicable global privacy laws, including...GDPR (Europe)", "confidence": "high" }, { "field": "sla_published", "url": "https://www.mapbox.com/legal/sla", "excerpt": "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.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.mapbox.com/api/navigation/map-matching/", "excerpt": "The Map Matching API is limited to 300 requests per minute.", "confidence": "high" }, { "field": "gdpr", "url": "https://www.mapbox.com/legal/privacy", "excerpt": "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.", "confidence": "high" }, { "field": "sla_published", "url": "https://www.mapbox.com/legal/sla", "excerpt": "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", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.mapbox.com/api/navigation/matrix/", "excerpt": "Standard profiles (driving, walking, cycling): Maximum 60 requests per minute... Traffic profile: Maximum 30 requests per minute", "confidence": "high" }, { "field": "known_restrictions", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "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", "confidence": "high" }, { "field": "known_restrictions", "url": "https://docs.mapbox.com/api/navigation/isochrone/", "excerpt": "Results must be displayed on a Mapbox map using one of the Mapbox libraries or SDKs.", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://docs.mapbox.com/api/guides/mcp-server/", "excerpt": "MCP Server | API Docs | Mapbox", "confidence": "high" }, { "field": "sdk_languages", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "Swift (Mapbox Directions for Swift), Java (Mapbox Java SDK), JavaScript (Mapbox JavaScript SDK), Ruby (Mapbox Ruby SDK)", "confidence": "high" }, { "field": "categories", "url": "https://docs.mapbox.com/android/maps/guides/pricing/", "excerpt": "Maps SDK MAUs cover any use of the Vector Tiles API and Raster Tiles API in an application that includes the Maps SDK", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "A valid Mapbox access token", "confidence": "high" }, { "field": "api_version", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "This documentation is for v5 of the Directions API", "confidence": "high" }, { "field": "deprecation_policy_url", "url": "https://docs.mapbox.com/api/guides/", "excerpt": "If we deprecate an API or API endpoint that you are using, we will email you to give you at least 90 days' notice.", "confidence": "medium" }, { "field": "sdk_packages (Java)", "url": "https://github.com/mapbox/mapbox-java", "excerpt": "The Mapbox Java SDK – Java wrappers around Mapbox APIs and other location data", "confidence": "high" }, { "field": "mcp_url", "url": "https://docs.mapbox.com/api/guides/mcp-server/", "excerpt": "https://mcp.mapbox.com/mcp", "confidence": "high" }, { "field": "quickstart_url", "url": "https://docs.mapbox.com/help/tutorials/getting-started-directions-api/", "excerpt": "Initialize a map with your access token, container, style, and coordinates; Build a getRoute() function using the Fetch API to request directions", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.mapbox.com/api/guides/", "excerpt": "Rate limits are tracked per access token (not per account). Responses include three rate limit headers: X-Rate-Limit-Interval (always 60 seconds), X-Rate-Limit-Limit (maximum requests allowed), X-Rate-Limit-Reset (Unix timestamp for counter reset). Exceeding limits returns HTTP 429 Too Many Requests.", "confidence": "medium" }, { "field": "data_retention_policy_url", "url": "https://www.mapbox.com/legal/dpa", "excerpt": "IP addresses are retained in cloudfront logs for 30 days for billing and customer usage reporting", "confidence": "high" }, { "field": "price_basis", "url": "https://www.mapbox.com/pricing", "excerpt": "Calculate optimal driving, walking, and cycling routes that take traffic and incidents into account.", "confidence": "high" }, { "field": "launched_at", "url": "https://en.wikipedia.org/wiki/Mapbox", "excerpt": "Mapbox was founded in 2010 in Washington, D.C., by four former Development Seed members.", "confidence": "medium" }, { "field": "error_format", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "code field (distinct from HTTP status); Success Value: 'Ok'", "confidence": "high" }, { "field": "known_restrictions", "url": "https://docs.mapbox.com/api/navigation/map-matching/", "excerpt": "Results must be displayed on a Mapbox map using one of the Mapbox libraries or SDKs.", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://www.mapbox.com/blog/introducing-the-mapbox-model-context-protocol-mcp-server", "excerpt": "the MCP Server simplifies the process by exposing a suite of geospatial capabilities that AI systems can call directly", "confidence": "high" }, { "field": "sandbox_available", "url": "https://www.mapbox.com/pricing", "excerpt": "Sign up and start building with meaningful free tiers for most products.", "confidence": "high" }, { "field": "categories", "url": "https://www.mapbox.com/maps", "excerpt": "Smooth, fast, cross-platform maps... Mapbox GL JS, Mobile Maps SDK, Studio, and Static Maps", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.mapbox.com/accounts/guides/tokens/", "excerpt": "Access tokens function as permission-based credentials for Mapbox API requests. Each token carries scopes — specific permissions determining which API operations are allowed.", "confidence": "high" }, { "field": "base_url", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "https://api.mapbox.com/directions/v5/{profile}/{coordinates}", "confidence": "high" }, { "field": "versioning_scheme", "url": "https://docs.mapbox.com/api/guides/", "excerpt": "Each API maintains an independent version string in the base URL. Changes considered backwards compatible (adding JSON properties, changing item counts, adjusting rate limits) do not increment versions. Breaking changes (removing properties, altering URL structure) trigger version increments.", "confidence": "high" }, { "field": "sdk_packages (Swift)", "url": "https://github.com/mapbox/mapbox-directions-swift", "excerpt": "Traffic-aware directions and map matching in Swift on iOS, macOS, tvOS, watchOS, and Linux", "confidence": "high" }, { "field": "sdk_packages (JavaScript)", "url": "https://github.com/mapbox/mapbox-gl-directions", "excerpt": "Directions plugin for mapbox-gl-js using Mapbox Directions API.", "confidence": "high" }, { "field": "mcp_url", "url": "https://www.mapbox.com/blog/introducing-the-mapbox-model-context-protocol-mcp-server", "excerpt": "Equip LLMs and AI agents with geospatial expertise", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.mapbox.com/api/navigation/directions/", "excerpt": "The Directions API has a maximum of 300 requests per minute. Requests that contain multiple coordinates are counted as 1 request.", "confidence": "medium" }, { "field": "sla_url", "url": "https://www.mapbox.com/legal/sla", "excerpt": "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.", "confidence": "high" }, { "field": "starting_price_usd", "url": "https://www.mapbox.com/pricing", "excerpt": "100,001 - 500,000 requests: $2.00 per 1,000", "confidence": "high" }, { "field": "free_tier_limit", "url": "https://www.mapbox.com/pricing", "excerpt": "Up to 100,000 monthly requests at no cost.", "confidence": "high" }, { "field": "notable_customers", "url": "https://www.mapbox.com/about/", "excerpt": "AccuWeather, DoorDash, Booking.com, Skyscanner, Instacart, Adobe, BMW, Yahoo Japan, Rever", "confidence": "high" }, { "field": "auth_docs_url", "url": "https://docs.mapbox.com/accounts/guides/tokens/", "excerpt": "Public tokens (pk): Contain only public scopes (styles:read, fonts:read, datasets:read, styles:tiles). Secret tokens (sk): Support secret scopes for sensitive operations.", "confidence": "high" } ], "fields_not_found": [ "hipaa (not mentioned on security page or legal-faq)", "iso_27001 (only ISO 9001 and TISAX listed; ISO 27001 not claimed)", "pci_dss (Mapbox uses Stripe for payment processing but does not claim PCI certification itself)", "transit/public-transport routing mode (not offered)", "truck/HGV-specific routing profile (not documented as a separate profile)", "ga_date", "idempotency_supported (no webhooks/async jobs; synchronous REST only - confirmed not applicable)", "webhook_events_url", "webhook_signing" ], "source_confidence": "high", "last_verified_at": "2026-06-14T00:00:00.000Z", "contribute": { "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.", "endpoints": [ { "action": "review", "label": "Leave a review or comment", "method": "POST", "url": "https://apio.sh/api/feedback/mapbox-directions", "example_body": { "kind": "review", "rating": 5, "body": "Your experience with this API…" } }, { "action": "field_edit", "label": "Suggest a correction to a field (cite a source)", "method": "POST", "url": "https://apio.sh/api/suggest/mapbox-directions/{field}", "example_body": { "value": "corrected value", "citations": [ { "url": "https://source.example/page", "excerpt": "supporting quote" } ], "note": "what changed and why" } }, { "action": "new_api", "label": "Suggest a new API to add", "method": "POST", "url": "https://apio.sh/api/suggest/api", "example_body": { "value": { "name": "Acme API", "website_url": "https://acme.example" }, "citations": [ { "url": "https://acme.example" } ] } }, { "action": "token", "label": "Optional - raise your rate limit", "method": "GET", "url": "https://apio.sh/api/feedback/token" } ] } }