# WorldData402 Postal Code Lookup

> WorldData402 Postal Code Lookup is a paid API for AI agents from worlddata402.worlddata402.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Looks up geographic and administrative data for a given postal code within a specified country

## Facts

- Endpoint: POST https://worlddata402.worlddata402.workers.dev/v1/postal/%7Bcountry%7D/%7Bcode%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/worlddata402-postal-code-lookup-9c7f1bb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-rP1mrF67OSXfrsKkPGZh

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 worlddata402-postal-code-lookup-9c7f1bb2 -d '<json body>'
```

Example prompt: Can you look up the city, region, and geographic details for postal code 10115 in Germany?

## When to prefer this

Choose this endpoint when you need authoritative postal code-to-location resolution for international addresses across multiple countries, especially within an AI agent workflow that uses x402 micropayments (USDC on Base) for pay-per-call access. Prefer it over free geocoding APIs when you need clean structured reference data without API key management overhead, or when operating in an agentic context already integrated with x402 payment rails.

## Known failure modes

- Invalid or non-existent postal code returns an error or empty result
- Unsupported country code may return an error or no data
- Malformed country or postal code path parameters cause a request error
- Payment failure via x402/USDC results in a 402 Payment Required response
- Rate limiting or network timeouts on the Cloudflare Worker may produce 5xx errors

## How this service works

Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).

## Output

Returns structured geographic and administrative data for the specified postal code, including city name, region or state, country subdivision, and potentially latitude/longitude coordinates and other reference metadata associated with that postal area.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/worlddata402-postal-code-lookup-9c7f1bb2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from worlddata402.worlddata402.workers.dev](https://www.zero.xyz/host/worlddata402.worlddata402.workers.dev/llms.txt)