Japan Address Mix API

Japanese addresses,
made usable.

Japan-wide address normalization with official sub-address verification where authoritative public data is available.

Try it free Get API Key Read the Docs Try on RapidAPI Run in Postman

Live and test credentials are isolated. Full API keys are shown only once.

POST/v1/address/resolveHTTP 200

{
  "result": {
    "postal_code": "100-0005",
    "normalized_address": {
      "prefecture": "東京都",
      "municipality": "千代田区",
      "town_area": "丸の内"
    },
    "codes": { "jis_code": "13101" }
  },
  "match": {
    "status": "matched",
    "confidence": "high",
    "match_level": "machiaza_detail",
    "coordinate_level": "municipality"
  }
}

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.

One careful answer from complicated Japanese address data.

Japan Address Mix API preserves uncertainty and source boundaries instead of flattening every result into a false success.

Postal code lookup

Detect hyphenated, plain, full-width, and 〒-prefixed Japanese postal codes.

Address normalization

Turn one natural Japanese query into consistent structured address fields.

Official enrichment

Combine Japan Post with Digital Agency ABR and Ministry of Justice parcel evidence where available.

Local government codes

Return JIS municipality codes and Machiaza IDs when the source supports them.

Coordinates with precision

Expose latitude and longitude together with their actual coordinate level.

Explainable confidence

Separate evidence score, confidence grade, match level, warnings, and provenance.

How it works

One input. Traceable decisions.

1
Normalize safely
Unicode, postal-code, and Japanese address-specific normalization without hiding the original input.
2
Resolve from official sources
Query Japan Post and the Digital Agency ABR, then verify residential-address or parcel detail against available official public data.
3
Explain the result
Return matched, partial, ambiguous, or not_found with candidates, warnings, and data versions.

Quick Start

Your first normalized result in minutes.

Full guide

1Get API Key

Create a live key in the dashboard.

2Copy request

Set the key as an environment variable.

3Send request

POST one query as JSON.

4Receive JSON

Inspect result, match, and warnings.

curl -X POST "https://api.japanapistore.com/v1/address/resolve" \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{"query":"〒100-0005 東京都千代田区丸の内1-1"}'

Data provenance

Quality claims you can inspect.

Every successful search response includes source versions and source-specific status. Residential and parcel-level evidence is marked preview, loaded from integrity-checked regional data, and reported separately from coordinate precision. Where lower-address public data is unavailable, the API returns a town-area fallback instead of guessing.

Japan Post: Postal code, prefecture, municipality, town area, kana
Digital Agency ABR: Structured matching, IDs, coordinates, match precision
JAPAN API STORE: Normalization, reconciliation, confidence grade, warnings

Build for Japan without hiding the hard parts.

Try the secret-safe console, read the contract-backed docs, or enrich Japanese companies with Business Mix.

Open API Console Explore Docs Run in Postman Explore Business Mix

Japanese addresses,made usable.