# Japan Postal Lookup

> Japan Postal Lookup is a paid API for AI agents from api.jpverify.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Looks up Japanese addresses by postal code, or finds postal codes by prefecture/city/ward/town components, against a local Japan Post snapshot.

## Facts

- Endpoint: POST https://api.jpverify.com/jp-address/postal-lookup?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-postal-lookup-87dc7a2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xOFBci8lFM7pIcevJPLTG

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 japan-postal-lookup-87dc7a2e -d '<json body>'
```

Example prompt: Can you look up the address details for Japanese postal code 150-0001 and return the prefecture, city, ward, and town — up to 5 results?

## When to prefer this

Choose this endpoint when you need to resolve a Japanese postal code to its address components, or find postal codes matching specific geographic components (prefecture, city, ward, town), using an authoritative Japan Post local data snapshot. Prefer it over general geocoding endpoints when the primary key is a postal code or address subdivision rather than a free-text address string. Use Japan Address Normalize or Japan Address Parse siblings when the input is a free-text address string rather than structured components.

## Known failure modes

- Invalid postal code format (must match \d{3}-?\d{4}) returns validation error
- No matching records found for given postal code or address components returns empty candidate list
- Ambiguous or incomplete address components may return too many or too few candidates
- max_results out of range (below 1 or above 50) returns validation error
- All fields null/missing with no search criteria returns error or empty result

## How this service works

Japanese postal-code lookup and reverse lookup. Keywords: Japanese postal lookup, Japan Post postal code, postal code reverse lookup, 日本郵便番号検索. Use a postal code or prefecture/city/ward/town components against the local Japan Post snapshot. / 通过邮编或都道府县、市区町村、区、町名字段，在本地 Japan Post 数据中进行日本邮编反查。

## Output

Returns a list of matching address candidates (up to max_results, default 10, max 50), each containing postal code, prefecture, city, ward, town, and county components sourced from the local Japan Post snapshot.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-postal-lookup-87dc7a2e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.jpverify.com](https://www.zero.xyz/host/api.jpverify.com/llms.txt)