South Korea

Property	Value
Code	`KR`
Currency	`KRW`
Region	Asia, Eastern Asia
Name order	Family name first
State	Province, a list of 17
Postcode	Required, checked, like `01600`, and by state
Rules	`GET /v1/countries/KR`

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`	Province (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]{5}$`
Example	`01600`
Written as	as typed
Checked by state	17 of 17, 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
Busan-gwangyeoksi	`4[6-9]\d{2}`
Chungcheongbuk-do	`2[789]\d{2}`
Chungcheongnam-do	`3[1-3]\d{2}`
Daegu-gwangyeoksi	`4[123]\d{2}`
Daejeon-gwangyeoksi	`3[45]\d{2}`
Gangwon-teukbyeoljachido	`2[456]\d{2}`
Gwangju-gwangyeoksi	`6[12]\d{2}`
Gyeonggi-do	`1[0-8]\d{2}`
Gyeongsangbuk-do	`(?:3[6-9]\|40)\d{2}`
Gyeongsangnam-do	`5[0-3]\d{2}`
Incheon-gwangyeoksi	`2[1-3]\d{2}`
Jeju-teukbyeoljachido	`63[0-356]\d`
Jeollabuk-do	`5[4-6]\d{2}`
Jeollanam-do	`5[7-9]\d{2}`
Sejong	`30[01]\d`
Seoul-teukbyeolsi	`0[1-8]\d{2}`
Ulsan-gwangyeoksi	`4[45]\d{2}`

Phone

Rule	Value
Calling code	`+82`
National prefix	`0`
Pattern	`^[0-9]{5,15}$`
Example	`010-2000-0000`
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

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

Written in Latin script, the lines differ:

CODE

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

On an envelope, the postal code is written in capitals.

Example

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

CODE

Seoul-teukbyeolsi 중구
소공로 70
홍 길동
04535
South Korea

The same address in Latin script:

CODE

Gil-dong Hong
70 Sogong-ro
Jung-gu
Seoul-teukbyeolsi
04535
South Korea

Province

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

Code	Name
`Busan-gwangyeoksi`	Busan-gwangyeoksi
`Chungcheongbuk-do`	Chungcheongbuk-do
`Chungcheongnam-do`	Chungcheongnam-do
`Daegu-gwangyeoksi`	Daegu-gwangyeoksi
`Daejeon-gwangyeoksi`	Daejeon-gwangyeoksi
`Gangwon-teukbyeoljachido`	Gangwon-teukbyeoljachido
`Gwangju-gwangyeoksi`	Gwangju-gwangyeoksi
`Gyeonggi-do`	Gyeonggi-do
`Gyeongsangbuk-do`	Gyeongsangbuk-do
`Gyeongsangnam-do`	Gyeongsangnam-do
`Incheon-gwangyeoksi`	Incheon-gwangyeoksi
`Jeju-teukbyeoljachido`	Jeju-teukbyeoljachido
`Jeollabuk-do`	Jeollabuk-do
`Jeollanam-do`	Jeollanam-do
`Sejong`	Sejong
`Seoul-teukbyeolsi`	Seoul-teukbyeolsi
`Ulsan-gwangyeoksi`	Ulsan-gwangyeoksi

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 01600
`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 province
`state`	`invalid`	Choose a province 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 010-2000-0000
`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