# Mapbox Reverse Geocode

> Mapbox Reverse Geocode is a paid API for AI agents from Mapbox at mapbox.mpp.paywithlocus.com, paid per call via MPP, $0.00375/call, status unknown (last checked 2026-10-11).

Converts geographic coordinates (latitude/longitude) into a human-readable address and place context using Mapbox

## Facts

- Endpoint: POST https://mapbox.mpp.paywithlocus.com/mapbox/geocode-reverse?utm_source=zero.xyz
- Price: $0.00375/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Mapbox
- Docs: https://docs.mapbox.com/api/
- Website: https://www.mapbox.com
- Tags: maps, geocoding, directions, routing, geospatial, data
- Canonical page: https://www.zero.xyz/c/mapbox-geocode-reverse-1d1873b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IVEhCeMVTpRcR9U7F9HuB

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-geocode-reverse-1d1873b6 -d '<json body>'
```

Example prompt: What street address and neighborhood corresponds to coordinates 40.7484° N, 73.9967° W? Give me 1 result in English.

## When to prefer this

Use this endpoint when you have GPS coordinates and need a human-readable address or place name — ideal for displaying location context in apps, enriching location data with address metadata, or resolving device GPS output to meaningful place names. Prefer over forward geocoding when you already have coordinates and need the address, not the other way around.

## Known failure modes

- Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns 422 validation error
- Coordinates in remote ocean or uninhabited area may return no features or sparse context
- limit outside range 1-5 returns validation error
- Invalid country code or language tag may be ignored or cause error
- Payment failure results in 402 response

## How this service works

Convert geographic coordinates (longitude, latitude) to an address or place name.

## Output

Returns a GeoJSON FeatureCollection with address features including street name and number, city/place, region with state code, country with ISO code, district, and exact coordinates — all structured in a rich context hierarchy per result.

## Example request

```json
{
 "limit": 1,
 "language": "en",
 "latitude": 40.7484,
 "longitude": -73.9967
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "longitude",
  "latitude"
 ],
 "properties": {
  "limit": {
   "type": "number",
   "description": "Maximum number of results (1-5, default 1)"
  },
  "types": {
   "type": "string",
   "description": "Filter by feature type"
  },
  "country": {
   "type": "string",
   "description": "Comma-separated ISO 3166-1 alpha-2 country codes"
  },
  "language": {
   "type": "string",
   "description": "IETF language tag for results"
  },
  "latitude": {
   "type": "number",
   "description": "Latitude (-90 to 90)"
  },
  "longitude": {
   "type": "number",
   "description": "Longitude (-180 to 180)"
  },
  "worldview": {
   "type": "string",
   "description": "Worldview code"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapbox-geocode-reverse-1d1873b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mapbox.mpp.paywithlocus.com](https://www.zero.xyz/host/mapbox.mpp.paywithlocus.com/llms.txt)