# Mapbox Isochrone API via Locus x402

> Mapbox Isochrone API via Locus x402 is a paid API for AI agents from mapbox.x402.paywithlocus.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Generates isochrone contours (reachable area polygons or linestrings) from a coordinate given travel time or distance limits and a routing profile.

## Facts

- Endpoint: POST https://mapbox.x402.paywithlocus.com/mapbox/isochrone
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapbox-isochrone-api-via-locus-x402-6b4781e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OwRdRyMuSwC4iK2qS7ROU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mapbox-isochrone-api-via-locus-x402-6b4781e1 -d '<json body>'
```

Example prompt: Show me the area reachable by walking within 10 and 20 minutes from coordinates -122.4194,37.7749 — return the results as polygons using the mapbox/walking profile.

## When to prefer this

Use this endpoint when you need to compute a geographic catchment or reachable-area contour from a single origin point, especially when you want polygon or linestring output for visualization or spatial analysis. Prefer this over simple radius buffers when realistic road-network travel time or distance matters. The pay-per-call x402 model makes it suitable for agents that call it occasionally without a Mapbox subscription.

## Known failure modes

- Invalid coordinate format — must be a single 'lon,lat' string
- contours_minutes value exceeds 60 or contours_meters exceeds 100000
- More than 4 contour values specified
- Unsupported routing profile string
- Payment failure or insufficient USDC balance via x402 protocol
- Network timeout for complex routing computations

## How this service works

Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.

## Output

Returns a GeoJSON FeatureCollection containing isochrone contours as either polygons or linestrings, representing the geographic area reachable within specified time or distance limits from the input coordinate. Also includes payment metadata (settled USDC amount) and a request ID for status tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "denoise": {
   "type": "number"
  },
  "exclude": {
   "type": "string"
  },
  "profile": {
   "type": "string"
  },
  "polygons": {
   "type": "boolean"
  },
  "generalize": {
   "type": "number"
  },
  "coordinates": {
   "type": "string"
  },
  "contours_meters": {
   "type": "string"
  },
  "contours_minutes": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapbox-isochrone-api-via-locus-x402-6b4781e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mapbox.x402.paywithlocus.com](https://www.zero.xyz/host/mapbox.x402.paywithlocus.com/llms.txt)