{"uid":"cap_mQ1zpld5kPqOtqhA-byFp","slug":"mapbox-directions-c8b758e1","name":"Mapbox Directions","description":"Get driving, walking, cycling, or traffic-aware routes between 2-25 coordinates.","url":"https://mapbox.mpp.paywithlocus.com/mapbox/directions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["profile","coordinates"],"properties":{"steps":{"type":"boolean","description":"Include turn-by-turn instructions"},"exclude":{"type":"string","description":"Road types to exclude: motorway, toll, ferry, unpaved, cash_only_tolls"},"profile":{"type":"string","description":"Routing profile: mapbox/driving, mapbox/driving-traffic, mapbox/walking, mapbox/cycling"},"language":{"type":"string","description":"Language for turn instructions (e.g. \"en\")"},"overview":{"type":"string","description":"Route geometry detail: full, simplified, false"},"geometries":{"type":"string","description":"Response geometry format: geojson, polyline, polyline6"},"annotations":{"type":"string","description":"Comma-separated: distance, duration, speed, congestion, maxspeed, closure"},"coordinates":{"type":"string","description":"Semicolon-separated lon,lat pairs (e.g. \"-73.99,40.73;-77.03,38.90\")"},"alternatives":{"type":"boolean","description":"Return up to 2 alternative routes"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"steps":true,"profile":"mapbox/driving","language":"en","overview":"simplified","geometries":"geojson","coordinates":"-73.9855,40.7580;-74.0060,40.7128"},"response":{"_truncated":true,"_originalSize":127532}},"exampleRequest":{"steps":true,"profile":"mapbox/driving","language":"en","overview":"simplified","geometries":"geojson","coordinates":"-73.9855,40.7580;-74.0060,40.7128"},"tags":["maps","geocoding","directions","routing","geospatial","data"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.67","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.5000","medianCents":"0.5000","p90Cents":"0.5000","minCents":"0.5000","maxCents":"0.5000","p95Cents":"0.5000","sampleCount":2,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IH2W8HXaF0RNDCXXAtNAc","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Mapbox","brandSlug":"mapbox","brandBaseUrl":"https://www.mapbox.com","brandDocsUrl":"https://docs.mapbox.com/api/","whatItDoes":"Calculates turn-by-turn routes between coordinates using driving, walking, or cycling profiles with traffic and road exclusion options","exampleAgentPrompt":"Give me walking directions with turn-by-turn steps in English from Times Square (-73.9855, 40.7580) to the National Mall in Washington DC (-77.0366, 38.8971), returning the route as GeoJSON with a simplified overview.","exampleUseCases":null,"resultDescription":"Returns one or more route objects containing geometry (GeoJSON, polyline, or polyline6), total distance and duration, step-by-step maneuver instructions with street names, and optional annotations like speed, congestion, and max speed per road segment.","failureModes":["Invalid coordinates format (not semicolon-separated lon,lat pairs) returns 422","Unsupported routing profile string returns validation error","Coordinates outside routable road network returns no-route error","Too many waypoints exceeds API limits","Invalid language code returns fallback or error","Excluding too many road types may make route impossible"],"whenToPreferThis":"Use this endpoint when you need point-to-point or multi-waypoint routing with rich navigation data including turn-by-turn instructions, traffic-aware driving, road type exclusions, and detailed geometry. Prefer over Matrix when you need full route details rather than just distance/duration summaries, and over Isochrone when you have a specific destination rather than a reachability area.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-09-12T23:49:55.668Z","lastSuccessfullyRanAt":"2026-09-12T23:49:55.668Z","lastHealthCheckAt":"2026-10-09T18:41:42.234Z","isFirstParty":false,"canonicalSlug":"mapbox-directions-c8b758e1"}