Japan Postal Code API

About Japan postal code (yubin bango)s

Japan uses 7-digit postal codes formatted as NNN-NNNN. The first three digits indicate the region and prefecture; 100-199 for Tokyo, 530-599 for Osaka.

Local term: postal code (yubin bango) | Regex pattern: ^\d{3}-?\d{4}$

API Usage Examples

curl -X POST https://postaldatapi.com/api/lookup \
  -H "Content-Type: application/json" \
  -d '{"zipcode": "100-0001", "country": "JP", "apiKey": "YOUR_API_KEY"}'

from postaldatapi import PostalDataPI

client = PostalDataPI(api_key="YOUR_API_KEY")
result = client.lookup("100-0001", country="JP")
print(result.place_name, result.latitude, result.longitude)

import { PostalDataPI } from 'postaldatapi';

const client = new PostalDataPI({ apiKey: 'YOUR_API_KEY' });
const result = await client.lookup('100-0001', { country: 'JP' });
console.log(result.placeName, result.latitude, result.longitude);