Japan

Property	Value
Code	`JP`
Currency	`JPY`
Region	Asia, Eastern Asia
Name order	Family name first
State	Prefecture, a list of 47
Postcode	Required, checked, like `100-0001`, and by state
Rules	`GET /v1/countries/JP`

Form

The address form, in English. A field that is not required shows its optional label.

Fields

Field	Label	Required	Autocomplete
`country`	Country (list)	yes	`country`
`last_name`	Last name	yes	`family-name`
`first_name`	First name	yes	`given-name`
`postcode`	Postal code	yes	`postal-code`
`state`	Prefecture (list)	yes	`address-level1`
`city`	City	yes	`address-level2`
`line1`	Address	yes	`address-line1`
`line2`	Apartment, suite, etc.	no	`address-line2`
`phone_number`	Phone number	no	`tel`
`email`	Email	yes	`email`

Postcode

Rule	Value
Required	yes
Pattern	`^[0-9]{7}$`
Example	`100-0001`
Written as	`###-####`
Checked by state	47 of 47, below

POST /v1/validate refuses a postcode sent with a state it does not start like, as not_in_state. A state not listed is checked by pattern only. From libaddressinput.

State	Starts with
Aichi	`4[4-9]\|431`
Akita	`01`
Aomori	`03\|018`
Chiba	`2[6-9]`
Ehime	`79`
Fukui	`91\|922`
Fukuoka	`8[0-3]\|871`
Fukushima	`9[67]`
Gifu	`50`
Gunma	`37\|38[49]`
Hiroshima	`7[23]`
Hokkaido	`0[4-9]\|00[1-7]`
Hyogo	`6[5-7]\|563`
Ibaraki	`3[01]`
Ishikawa	`92\|939`
Iwate	`02`
Kagawa	`76`
Kagoshima	`89`
Kanagawa	`2[1-5]\|199`
Kochi	`78`
Kumamoto	`86`
Kyoto	`6[0-2]\|520`
Mie	`51\|498\|647`
Miyagi	`98`
Miyazaki	`88`
Nagano	`3[89]\|949`
Nagasaki	`85\|81[17]\|848`
Nara	`63\|64[78]`
Niigata	`9[45]\|389`
Oita	`87\|839`
Okayama	`7[01]`
Okinawa	`90`
Osaka	`5[3-9]\|618\|630`
Saga	`84`
Saitama	`3[3-6]`
Shiga	`52`
Shimane	`69\|68[45]`
Shizuoka	`4[1-9]`
Tochigi	`32\|311\|349`
Tokushima	`77`
Tokyo	`1[0-8]\|19[0-8]\|20`
Tottori	`68`
Toyama	`93`
Wakayama	`64\|519`
Yamagata	`99`
Yamaguchi	`7[45]`
Yamanashi	`40`

Phone

Rule	Value
Calling code	`+81`
National prefix	`0`
Pattern	`^[0-9]{8,18}$`
Example	`090-1234-5678`
Written as	`###-####-####`

Address format

How an address is written for reading, on an order page, a receipt or a label: address.format in the rules.

CODE

〒{postcode}
{state} {city}
{line1}
{line2}
{last_name} {first_name}
{country}

Written in Latin script, the lines differ:

CODE

{first_name} {last_name}
{line1}
{line2}, {city}, {state}
{postcode}
{country}

On an envelope, the prefecture is written in capitals.

Example

A real address in Japan, from address.example, written with the format and the state by its name:

CODE

〒100-8791
Tokyo 千代田区
大手町2-3-1
大手町プレイス ウエストタワー
山田 太郎
Japan

The same address in Latin script:

CODE

Taro Yamada
2-3-1 Otemachi
Otemachi Place West Tower, Chiyoda-ku, Tokyo
100-8791
Japan

Prefecture

The form submits the code, which is what an order stores; the name is what the shopper reads, in their language.

Code	Name
`Aichi`	Aichi
`Akita`	Akita
`Aomori`	Aomori
`Chiba`	Chiba
`Ehime`	Ehime
`Fukui`	Fukui
`Fukuoka`	Fukuoka
`Fukushima`	Fukushima
`Gifu`	Gifu
`Gunma`	Gunma
`Hiroshima`	Hiroshima
`Hokkaido`	Hokkaido
`Hyogo`	Hyogo
`Ibaraki`	Ibaraki
`Ishikawa`	Ishikawa
`Iwate`	Iwate
`Kagawa`	Kagawa
`Kagoshima`	Kagoshima
`Kanagawa`	Kanagawa
`Kochi`	Kochi
`Kumamoto`	Kumamoto
`Kyoto`	Kyoto
`Mie`	Mie
`Miyagi`	Miyagi
`Miyazaki`	Miyazaki
`Nagano`	Nagano
`Nagasaki`	Nagasaki
`Nara`	Nara
`Niigata`	Niigata
`Oita`	Oita
`Okayama`	Okayama
`Okinawa`	Okinawa
`Osaka`	Osaka
`Saga`	Saga
`Saitama`	Saitama
`Shiga`	Shiga
`Shimane`	Shimane
`Shizuoka`	Shizuoka
`Tochigi`	Tochigi
`Tokushima`	Tokushima
`Tokyo`	Tokyo
`Tottori`	Tottori
`Toyama`	Toyama
`Wakayama`	Wakayama
`Yamagata`	Yamagata
`Yamaguchi`	Yamaguchi
`Yamanashi`	Yamanashi

Messages

What the form shows under a field when a value is refused, in English. Every language is on its page under Languages.

Field	Error	Message
`country`	`not_selected`	Select a country
`last_name`	`blank`	Enter a last name
`last_name`	`invalid_characters`	Last name can only contain letters, spaces, hyphens and apostrophes
`last_name`	`contains_emoji`	Last name can't contain emojis
`last_name`	`too_long`	Last name must be 255 characters or fewer
`first_name`	`blank`	Enter a first name
`first_name`	`invalid_characters`	First name can only contain letters, spaces, hyphens and apostrophes
`first_name`	`contains_emoji`	First name can't contain emojis
`first_name`	`too_long`	First name must be 255 characters or fewer
`postcode`	`blank`	Enter a postal code
`postcode`	`invalid`	Enter a valid postal code, like 100-0001
`postcode`	`contains_emoji`	Postal code can't contain emojis
`postcode`	`too_long`	Postal code must be 64 characters or fewer
`state`	`not_selected`	Select a prefecture
`state`	`invalid`	Choose a prefecture from the list
`city`	`blank`	Enter a city
`city`	`invalid`	Enter a valid city
`city`	`contains_emoji`	City can't contain emojis
`city`	`too_long`	City must be 255 characters or fewer
`line1`	`blank`	Enter an address
`line1`	`contains_emoji`	Address can't contain emojis
`line1`	`too_long`	Address must be 255 characters or fewer
`line2`	`blank`	Enter address line 2
`line2`	`contains_emoji`	Address line 2 can't contain emojis
`line2`	`too_long`	Address line 2 must be 255 characters or fewer
`phone_number`	`blank`	Enter a phone number
`phone_number`	`invalid`	Enter a valid phone number, like 090-1234-5678
`phone_number`	`contains_emoji`	Phone number can't contain emojis
`phone_number`	`too_long`	Phone number must be 24 characters or fewer
`email`	`blank`	Enter an email address
`email`	`invalid`	Enter a valid email, like name@example.com
`email`	`contains_emoji`	Email can't contain emojis
`email`	`too_long`	Email must be 254 characters or fewer