MoIS

A South Korean road name address (도로명주소) as published by the Ministry of the Interior and Safety (MOIS).

Every address is indexed twice, once in Hangul and once in Revised Romanization. line_1 and line_2 follow the language of the matched document; the API returns the underlying MOIS fields under their original Hangul names.

Korean-named fields are empty strings when the source record does not carry a value.

Example Record

Field	Example	Type
id	mois_hM9Ur94A6Wxd8rFfQWHjKQ	string
dataset	mois	string
country	South Korea	string
country_iso	KOR	string
country_iso_2	KR	string
language	ko	string
address	108-21	string
line_1	종로구 청운동 자하문로 108-21	string
line_2	청운빌딩 100동 1호	string
city	서울특별시	string
province	서울특별시	string
법정읍면동명	청운동	string
법정동코드	1111010100	string
법정리명	Empty in this example	string
비고1	Empty in this example	string
비고2	Empty in this example	string
변동전도로명주소	Empty in this example	string
변경이력정보	Empty in this example	string
변경이력사유	Empty in this example	string
변경전_도로명주소	Empty in this example	string
변경사유	Empty in this example	string
변경사유코드	Empty in this example	string
층일련번호	Empty in this example	string
층명칭	Empty in this example	string
대표지번여부	Empty in this example	string
대표여부	Empty in this example	string
다량배달처명	Empty in this example	string
동일련번호	Empty in this example	string
동명칭	Empty in this example	string
도로명	자하문로	string
도로명_로마자	Empty in this example	string
도로명번호	3100012	string
도로명코드	111103100012	string
도로명코드_고시일자	20100702	string
도로명코드_말소일자	Empty in this example	string
읍면동구분	1	string
읍면동일련번호	01	string
읍면동코드	101	string
읍면동명	청운동	string
읍면동명_로마자	Empty in this example	string
건축물대장_건물명	Empty in this example	string
건물본번	100	string
건물부번	1	string
건물관리번호	1111010100101080021031434	string
기초구역번호	03047	string
공동주택여부	0	string
고시일자	Empty in this example	string
관리번호	Empty in this example	string
행정동코드	1111051500	string
행정동명	청운효자동	string
호일련번호	Empty in this example	string
호명칭	Empty in this example	string
호접미사일련번호	Empty in this example	string
호접미사명칭	Empty in this example	string
이동사유코드	Empty in this example	string
일련번호	Empty in this example	string
지번일련번호	Empty in this example	string
지번본번_번지	108	string
지번부번_호	21	string
지하구분	Empty in this example	string
지하여부	0	string
산여부	0	string
상위도로명	Empty in this example	string
상위도로명번호	Empty in this example	string
상세건물명	Empty in this example	string
상세주소_부여여부	Empty in this example	string
상세주소여부	0	string
사용여부	0	string
시도명	서울특별시	string
시도명_로마자	Empty in this example	string
시군구_건물명	Empty in this example	string
시군구코드	11110	string
시군구명	종로구	string
시군구명_로마자	Empty in this example	string
시군구용_건물명	청운빌딩	string
우편일련번호	Empty in this example	string
우편번호	03047	string
우편번호_일련번호	Empty in this example	string
영문_법정리명	Empty in this example	string
영문읍면동명	Cheongun-dong	string
영문_법정읍면동명	Empty in this example	string
영문도로명	Jahamun-ro	string
영문시도명	Seoul	string
영문시군구명	Jongno-gu	string

Every field is documented below.

Essential Elements

id string

ID

Example mois_hM9Ur94A6Wxd8rFfQWHjKQ

dataset string

Dataset

Dataset the address originates from.

Example mois

Enum

• "mois"

country string

Country

Full country names (ISO 3166)

Example South Korea

Enum

• "South Korea"

country_iso string

Country ISO

3 letter country code (ISO 3166-1)

Example KOR

Enum

• "KOR"

country_iso_2 string

Country ISO 2

2 letter country code (ISO 3166-1)

Example KR

Enum

• "KR"

language string

Language

Language represented by 2 letter ISO Code (639-1)

Example ko

Enum

• "ko"

line_1 string

Address Line 1

First address line.

Can be empty string "" if not present.

Example 종로구 청운동 자하문로 108-21

line_2 string

Address Line 2

Second address line.

Can be empty string "" if not present.

Example 청운빌딩 100동 1호

city string

City

Preferred city name.

Can be empty string "" if not present.

Example 서울특별시

province string

Province

Preferred province name.

Can be empty string "" if not present.

Example 서울특별시

Administrative Division

법정읍면동명 string

법정읍면동명 (Legal town/township/neighbourhood name)

Legal town name.

Can be empty string "" if not present.

Example 청운동

법정동코드 string

법정동코드 (Legal neighbourhood code)

Legal district code.

Can be empty string "" if not present.

Example 1111010100

법정리명 string

법정리명 (Legal village name)

Legal name.

Can be empty string "" if not present.

Example Empty in this example

행정동코드 string

행정동코드 (Administrative neighbourhood code)

Administrative district code.

Can be empty string "" if not present.

Example 1111051500

행정동명 string

행정동명 (Administrative neighbourhood name)

Administrative district name.

Can be empty string "" if not present.

Example 청운효자동

시도명 string

시도명 (Province or metropolitan city name)

City name.

Can be empty string "" if not present.

Example 서울특별시

시도명_로마자 string

시도명\\_로마자 (Province/metropolitan city name (romanised))

Romanised city name.

Can be empty string "" if not present.

Example Empty in this example

시군구코드 string

시군구코드 (City/county/district code)

District code.

Can be empty string "" if not present.

Example 11110

시군구명 string

시군구명 (City/county/district name)

District name.

Can be empty string "" if not present.

Example 종로구

시군구명_로마자 string

시군구명\\_로마자 (City/county/district name (romanised))

Romanised district name.

Can be empty string "" if not present.

Example Empty in this example

읍면동구분 string

읍면동구분 (Town/township/neighbourhood type)

Town classification.

Can be empty string "" if not present.

Example 1

읍면동일련번호 string

읍면동일련번호 (Town/township/neighbourhood sequence number)

Town serial number.

Can be empty string "" if not present.

Example 01

읍면동코드 string

읍면동코드 (Town/township/neighbourhood code)

Town code.

Can be empty string "" if not present.

Example 101

읍면동명 string

읍면동명 (Town/township/neighbourhood name)

Town name.

Can be empty string "" if not present.

Example 청운동

읍면동명_로마자 string

읍면동명\\_로마자 (Town/township/neighbourhood name (romanised))

Romanised town name.

Can be empty string "" if not present.

Example Empty in this example

Buildings

건축물대장_건물명 string

건축물대장\\_건물명 [Building name (official registry)]

Building name in building register.

Can be empty string "" if not present.

Example Empty in this example

건물본번 string

건물본번 [Main building number]

Building number.

Can be empty string "" if not present.

Example 100

건물부번 string

건물부번 [Building sub-number]

Building sub-number.

Can be empty string "" if not present.

Example 1

건물관리번호 string

건물관리번호 [Building management number]

Building management number.

Can be empty string "" if not present.

Example 1111010100101080021031434

상세건물명 string

상세건물명 [Detailed building name]

Detailed building name.

Can be empty string "" if not present.

Example Empty in this example

시군구_건물명 string

시군구\\_건물명 [Building name (city/county/district level)]

District (sigungu) building name, as recorded in the address DB (주소DB).

Can be empty string "" if not present.

Example Empty in this example

시군구용_건물명 string

시군구용\\_건물명 [Building name used for city/county/district]

District (sigungu) building name, as recorded in the building and PO box DBs (건물DB, 사서함주소DB).

Can be empty string "" if not present.

Example 청운빌딩

Road Name & Address History

도로명 string

도로명 [Street name]

Road name.

Can be empty string "" if not present.

Example 자하문로

도로명_로마자 string

도로명\\_로마자 [Street name (romanised)]

Romanised road name.

Can be empty string "" if not present.

Example Empty in this example

도로명번호 string

도로명번호 [Street number]

Road name number.

Can be empty string "" if not present.

Example 3100012

도로명코드 string

도로명코드 [Street code]

Road name code.

Can be empty string "" if not present.

Example 111103100012

도로명코드_고시일자 string

도로명코드\\_고시일자 [Street code official date]

Road name code creation date.

Can be empty string "" if not present.

Example 20100702

도로명코드_말소일자 string

도로명코드\\_말소일자 [Street code deletion date]

Road name code deletion date.

Can be empty string "" if not present.

Example Empty in this example

상위도로명 string

상위도로명 [Higher-level street name]

Upper road name.

Can be empty string "" if not present.

Example Empty in this example

상위도로명번호 string

상위도로명번호 [Higher-level street number]

Upper road name number.

Can be empty string "" if not present.

Example Empty in this example

변동전도로명주소 string

변동전도로명주소 [Previous road name address (before change)]

Changed street name address.

Can be empty string "" if not present.

Example Empty in this example

변경전_도로명주소 string

변경전\\_도로명주소 [Previous road name address]

Previous road name address.

Can be empty string "" if not present.

Example Empty in this example

Change Tracking

변경이력정보 string

변경이력정보 [Change history info]

Change history information.

Can be empty string "" if not present.

Example Empty in this example

변경이력사유 string

변경이력사유 [Reason for change history]

Change history reason.

Can be empty string "" if not present.

Example Empty in this example

변경사유 string

변경사유 [Reason for change]

Change reason.

Can be empty string "" if not present.

Example Empty in this example

변경사유코드 string

변경사유코드 [Change reason code]

Change reason code.

Can be empty string "" if not present.

Example Empty in this example

이동사유코드 string

이동사유코드 [Relocation reason code]

Movement reason code.

Can be empty string "" if not present.

Example Empty in this example

Structure: Floors & Units

층일련번호 string

층일련번호 [Floor sequence number]

Floor serial number.

Can be empty string "" if not present.

Example Empty in this example

층명칭 string

층명칭 [Floor name]

Floor name.

Can be empty string "" if not present.

Example Empty in this example

호일련번호 string

호일련번호 [Unit sequence number]

Unit serial number.

Can be empty string "" if not present.

Example Empty in this example

호명칭 string

호명칭 [Unit name]

Unit name.

Can be empty string "" if not present.

Example Empty in this example

호접미사일련번호 string

호접미사일련번호 [Unit suffix sequence number]

Unit suffix serial number.

Can be empty string "" if not present.

Example Empty in this example

호접미사명칭 string

호접미사명칭 [Unit suffix name]

Unit suffix name.

Can be empty string "" if not present.

Example Empty in this example

Land Parcel Info

지번일련번호 string

지번일련번호 [Parcel sequence number]

Address serial number.

Can be empty string "" if not present.

Example Empty in this example

지번본번_번지 string

지번본번\\_번지 [Parcel main number]

Jibeon (land lot) main number.

Can be empty string "" if not present.

Example 108

지번부번_호 string

지번부번\\_호 [Parcel sub-number]

Jibeon (land lot) sub-number.

Can be empty string "" if not present.

Example 21

지하구분 string

지하구분 [Underground classification]

Is basement.

Can be empty string "" if not present.

Example Empty in this example

지하여부 string

지하여부 [Is underground]

Level (ground level, underground, aerial).

Can be empty string "" if not present.

Example 0

산여부 string

산여부 [Is mountain area]

Is mountain.

Can be empty string "" if not present.

Example 0

Postal

대표지번여부 string

대표지번여부 [Is representative land-lot]

Is representative address.

Can be empty string "" if not present.

Example Empty in this example

대표여부 string

대표여부 [Is representative address]

Is representative.

Can be empty string "" if not present.

Example Empty in this example

동일련번호 string

동일련번호 [Same sequence number]

Building serial number.

Can be empty string "" if not present.

Example Empty in this example

동명칭 string

동명칭 [Block/building name]

Building name.

Can be empty string "" if not present.

Example Empty in this example

상세주소_부여여부 string

상세주소\\_부여여부 [Is detailed address assigned]

Whether detailed address assigned.

Can be empty string "" if not present.

Example Empty in this example

상세주소여부 string

상세주소여부 [Has detailed address]

Whether detailed address exists.

Can be empty string "" if not present.

Example 0

공동주택여부 string

공동주택여부 [Is multi-dwelling building]

Is apartment.

Can be empty string "" if not present.

Example 0

사용여부 string

사용여부 [Is in use]

In use.

Can be empty string "" if not present.

Example 0

고시일자 string

고시일자 [Official notice date]

Creation date.

Can be empty string "" if not present.

Example Empty in this example

관리번호 string

관리번호 [Management number]

Management number.

Can be empty string "" if not present.

Example Empty in this example

일련번호 string

일련번호 [Serial number]

Serial number.

Can be empty string "" if not present.

Example Empty in this example

비고1 string

비고1 [Note 1]

Note 1.

Can be empty string "" if not present.

Example Empty in this example

비고2 string

비고2 [Note 2]

Note 2.

Can be empty string "" if not present.

Example Empty in this example