# httpay.xyz Mapbox Geocoding API Gateway

> httpay.xyz Mapbox Geocoding API Gateway is a paid API for AI agents from httpay.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Proxies Mapbox geocoding requests to convert place names or addresses into geographic coordinates and location data, billed per call via x402 micropayment

## Facts

- Endpoint: POST https://httpay.xyz/api/gateway/mapbox/geocoding/v5/mapbox.places/San%20Francisco.json
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/httpay-xyz-mapbox-geocoding-api-gateway-da8208c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6zM-I5s1GzJuJBylKfezG

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 httpay-xyz-mapbox-geocoding-api-gateway-da8208c4 -d '<json body>'
```

Example prompt: Can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' using Mapbox and give me the latitude and longitude coordinates?

## When to prefer this

Use this endpoint when you need Mapbox-quality geocoding without managing your own Mapbox API key — ideal for agents that need pay-per-use location resolution via x402 micropayments without API key setup overhead. Prefer over raw Mapbox API when you want a metered, keyless integration.

## Known failure modes

- Invalid or ambiguous place name returns empty features array
- Malformed search text returns 400 error
- Service unavailable or payment failure returns non-200 status
- Rate limiting or quota exceeded on the underlying Mapbox API
- No matching results for obscure or misspelled location names

## How this service works

API Gateway: Mapbox maps & location API (key in query)

## Output

Returns a GeoJSON FeatureCollection with matching place features, each containing coordinates (longitude, latitude), place name, place type (e.g. address, locality, region), relevance score, and bounding box. Follows the standard Mapbox Geocoding API v5 response format.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/httpay-xyz-mapbox-geocoding-api-gateway-da8208c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from httpay.xyz](https://www.zero.xyz/host/httpay.xyz/llms.txt)