Service
Normalized Japanese postal-code (ZIP) to address lookup backed by the public zipcloud API: 7-digit code in, prefecture/city/town matches with half-width katakana readings and JIS X 0401 prefecture codes out.
99.95%30-day uptimeAvg response433ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/japan-post-zip/search-postal-code | Resolves a 7-digit Japanese postal code (ZIP) into normalized address matches via the public zipcloud lookup API. Use when the user provides a Japanese postal code such as 7830060 or 100-0001 (send digits only) and needs the prefecture, city, and town it belongs to, including half-width katakana readings and the JIS X 0401 prefecture code. Boundary codes can return multiple matches. Coverage is Japan Post KEN_ALL town-level data only: match_found:false with zero matches means the code has no KEN_ALL entry — either genuinely unassigned OR a real, assigned large-office individual code (大口事業所個別番号, e.g. 100-8111 for the Imperial Household Agency), which zipcloud does not carry. A no-match is a normal result, not an error, but it is NOT proof the postal code does not exist. Do NOT use for reverse lookup (address to postal code), non-Japanese postal codes, or partial/prefix search — the upstream only supports exact 7-digit lookup. No account or credentials required. Returns the echoed postal_code, match_found, a matches array (postal_code, prefecture, prefecture_code, prefecture_kana, city, city_kana, town, town_kana) and returned_count. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
