# Japan Address Geocode

> Japan Address Geocode is a paid API for AI agents from api.jpverify.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Converts a Japanese address string into geographic coordinates using building-level forward geocoding via Jageocoder, returning candidates with hierarchy levels, coordinate pairs, and partial-match warnings.

## Facts

- Endpoint: POST https://api.jpverify.com/jp-address/geocode
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-address-geocode-5126946f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7suUsqI7lX017UctGKk18

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-address-geocode-5126946f -d '<json body>'
```

Example prompt: Can you geocode this Japanese address to coordinates — 東京都渋谷区道玄坂1丁目12-1 — and give me up to 3 candidates with at least block-level precision (level 7)?

## When to prefer this

Choose this endpoint when you need building-level or block-level coordinate resolution for Japanese addresses specifically, particularly when you require hierarchy-level metadata (chome/block/building), partial-match detection, or provider-neutral local geocoding via Jageocoder. Prefer over generic international geocoders (Google Maps, HERE) when you need Japan-specific granularity, cost predictability at $0.005/call, or when operating in a pipeline alongside other jpverify.com address services (normalize, parse, validate).

## Known failure modes

- Address not found in Jageocoder dictionary — returns empty candidates list or partial match below minimum level
- Malformed address string — ambiguous or incomplete input may return lower-hierarchy matches only
- Invalid postal code format — rejected if pattern does not match \d{3}-?\d{4}
- max_candidates out of range (must be 1–10) — validation error
- minimum_acceptable_level out of range (must be 1–8) — validation error
- Payment failure — x402 payment required before response is returned

## Output

Returns a list of geocoding candidates (up to max_candidates), each with latitude/longitude coordinates, a hierarchy level (6=chome, 7=block, 8=building/house), an address ID, the matched address components, and a flag indicating whether the match is partial (below the minimum_acceptable_level threshold).

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-address-geocode-5126946f/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)