# x402 Geocoder Batch

> x402 Geocoder Batch is a paid API for AI agents from x402-geocoder-production.up.railway.app, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-18).

Geocodes up to 1000 US addresses in a single call, returning lat/lng and US Census FIPS codes for each, keyed by user-provided ID.

## Facts

- Endpoint: POST https://x402-geocoder-production.up.railway.app/geocode/batch?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-geocoder-batch-e6b71bc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I-_zjk7GXfLg4PU46wTaN

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 x402-geocoder-batch-e6b71bc4 -d '<json body>'
```

Example prompt: I have a list of 800 US customer addresses — can you geocode all of them in one shot and give me back their lat/lng coordinates keyed by the customer ID I provide?

## When to prefer this

Use this endpoint when you need to geocode more than one US address at a time and want cost efficiency — at $0.001 per address (flat $0.50 per batch for up to 1000), it is far cheaper per address than the single-address endpoint. Ideal for enriching datasets, preparing delivery manifests, or any workflow where you have tens to hundreds of addresses to resolve in one shot. Prefer the single-address sibling endpoint for one-off lookups.

## Known failure modes

- Batch exceeds 1000 addresses — request rejected
- Malformed address objects missing required 'id' or 'street' fields — validation error
- Unresolvable or ambiguous addresses — those IDs may be missing or null in the response
- Payment failure or insufficient USDC balance — 402 response before processing
- Network timeout for very large batches near the 1000-address limit

## How this service works

Geocode up to 1000 US addresses in a single call. Flat $0.001 per batch — much cheaper per address at scale than the single-address endpoint. JSON body: an array of { id, street, city?, state?, zip? } objects, or { addresses: [...] }. Response is an object map keyed by the user-provided 'id' so results can be joined back to inputs.

## Output

A JSON object map keyed by the user-provided 'id' for each input address. Each value contains the resolved latitude, longitude, and US Census FIPS codes (state, county, tract, block) for that address. Addresses that could not be resolved may be absent or flagged in the response.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-geocoder-batch-e6b71bc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-geocoder-production.up.railway.app](https://www.zero.xyz/host/x402-geocoder-production.up.railway.app/llms.txt)