{"uid":"cap_O2YIEq9TLuvZx8sTAU0Uw","slug":"locus-x402-mapbox-directions-api-d82650aa","name":"Locus x402 Mapbox Directions API","description":"Locus public pay-per-use API","url":"https://mapbox.x402.paywithlocus.com/mapbox/directions","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"steps":{"type":"boolean"},"exclude":{"type":"string"},"profile":{"type":"string"},"language":{"type":"string"},"overview":{"type":"string"},"geometries":{"type":"string"},"annotations":{"type":"string"},"coordinates":{"type":"string"},"alternatives":{"type":"boolean"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mB94ibe5uRejmEZT3y0JQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns turn-by-turn driving, walking, or cycling route directions between coordinates using Mapbox routing, billed per call via x402 micropayment.","exampleAgentPrompt":"Get me driving directions with turn-by-turn instructions from -73.99,40.73 to -77.03,38.90, avoiding tolls, and return the route geometry as GeoJSON in English.","exampleUseCases":[{"title":"Road trip route planning","prompt":"Give me driving directions with traffic from -87.63,41.88 to -93.62,41.60, show me up to 2 alternative routes, and include congestion annotations so I can pick the fastest option."},{"title":"Cycling navigation with exclusions","prompt":"Find me a cycling route from -122.42,37.77 to -122.45,37.87 with turn-by-turn instructions in English, avoiding ferries and unpaved roads, and return the full route geometry as GeoJSON."},{"title":"Pedestrian walking directions","prompt":"Get me walking directions from -0.12,51.50 to -0.08,51.51 with simplified geometry and step-by-step instructions in French."}],"resultDescription":"Returns a JSON object containing one or more routes, each with geometry (in the requested format), distance in meters, duration in seconds, optional turn-by-turn step instructions, and optional annotations (speed, duration, distance, congestion, maxspeed, closure) per road segment. Includes up to 2 alternative routes if requested.","failureModes":["Invalid coordinates format (not semicolon-separated lon,lat pairs) returns an error","Unsupported routing profile string returns a validation error","Payment failure via x402 protocol blocks the request","Coordinates outside supported coverage area may return no routes","Invalid language code may fall back to default or error","Requesting annotations for unsupported profile may return partial data"],"whenToPreferThis":"Choose this endpoint when you need Mapbox-quality routing with micropayment billing via x402 (no API key subscription required), support for multiple transport modes (driving with/without traffic, walking, cycling), road-type exclusions, and rich annotations including congestion. Prefer over generic geocoding APIs when you need actual route geometry and turn-by-turn navigation data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:43.987Z","isFirstParty":false}