Japan Address Mix API

Use Japanese addresses without hiding ambiguous matches.

Use Japan Address Mix API when a checkout, CRM or logistics product needs structured prefecture, municipality and town fields from a Japanese address or postal code. It preserves the input, reports match quality, and keeps source and coordinate precision separate.

Try live demo Get a free API key Read the docs

Built in Japan · English-first JSON · Official and public source provenance · No government endorsement claimed

NO SIGN-UP · NO API KEY

Normalize a Japanese address now

Paste an address or use an example. The browser demo calls a rate-limited anonymous route and stores no query for marketing.

Try it free — no signup

Make a Japanese address usable

Enter one address and see how Japan Address Mix organizes it. Start with a sample if you like.

No API key · Rate limited · Inputs are not saved

Japanese address

Try a sample

You can use Japanese characters, a postal code, or a full address.

Your easy-to-read result appears here.

No account, API knowledge, or card is needed.

PRODUCTION REQUEST

Copy a request, then inspect the actual response contract.

The free key uses the same documented endpoint. Put the secret in a server-side environment variable and never commit it.

curl -X POST https://api.japanapistore.com/v1/address/resolve \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" -H "Content-Type: application/json" \
  -d '{"query":"大阪府大阪市北区梅田3丁目1-1"}'

Representative responseFields depend on evidence and input.

{"success":true,"match":{"status":"matched","precision":"block"},"address":{"prefecture":"大阪府","municipality":"大阪市北区","town_area":"梅田","chome":"3丁目"},"warnings":[],"sources":[{"provider":"japan_post","status":"matched"},{"provider":"digital_agency_abr","status":"matched"}]}

SOURCES, FRESHNESS, LIMITS

Evidence you can inspect—not a black-box “Japan answer.”

Japan Post and Address Base Registry versions are reported independently in the response.

Japan Post

Used for: Postal codes, prefectures, municipalities, town areas and kana.
Freshness: The active source version is returned in API provenance.
Transformation: JAPAN API STORE normalizes fields and reconciles them with Digital Agency address evidence.

Digital Agency Address Base Registry

Used for: Structured Japanese address identifiers, hierarchy and coordinates where public evidence exists.
Freshness: Dataset version and source status are returned separately from Japan Post.
Transformation: Matches are graded without treating coordinate precision as address precision.

FREE DEVELOPER TIER

Use the demo now. Create a key only when you are ready to build.

No credit card for the free key. One dashboard gives access to the four existing APIs.

Get a free API key First 200 OK guide OpenAPIPostman