OPENAPI Detail

XML

Parcel adress search service

This is an OPEN API related to the 5-digit postal code inquiry information of the lot number address that provides a function to search the new postal code (effective August 1, 2015) and the existing postal code of the new address system. ㅇ Items to be output (data the user will receive in response): number, postal code, lot address

※ Application for use is only available on the PC version.

Parcel adress search service Information such as classification and provision of file data information system
Classified Transportation and logistics - Logistics, etc. Provided By
Department Department No
API Type REST Data Format XML
Usage 2010 Keyword economy/management,Marketing,Logistics/distribution management
Registered 2015-03-16 Edited 2022-10-24
Deliberation Type dev : allow / run : allow
Payment free
Scope of License
References (지번주소 조회서비스) 지번주소5자리우편번호조회서비스명세서.hwp

Function

The service that search for EarthNumberAddress and NewZipCode(5-space) using RoadNameAddress

  • Application for Use Development level : allowed / Operation level : allowed
  • Available traffic 10000 / Operational account can increase traffic by applying for use case registration
  • Requested Link
  • Service URL http://openapi.epost.go.kr/postal/retrieveLotNumberAdressAreaCdService/retrieveLotNumberAdressAreaCdService/getDetailListAreaCd

Request Parameter

Request Parameter

Category(Korean) Category(English) Size Division Sample Data Description
검색구분 searchSe 1 Essential dong dong: name of dong (eup/myeon)/apartment/building namepost: postal code sido: city/gun/gu
검색어 srchwrd 200 Essential 빛가람동 search word
페이지당 출력 개수 countPerPage 10 Optional 10 Specifies the number of prints per page
출력될 페이지 번호 currentPage 10 Optional 1 Page number to be printed

Response Element

Response Element

Category(Korean) Category(English) Size Division Sample Data Description
번호 no 10 Essential 1 number
우편번호 zipNo 5 Essential 58321 5-digit postal code
지번주소 adres 200 Essential 전라남도 나주시 빛가람동 Lot number address range corresponding to the new address
전체 데이터 개수 totalCount 10 Optional 32 Number of retrieved data
페이지당 출력 개수 countPerPage 10 Optional 10 Number of prints per page
전체 페이지수 totalPage 10 Optional 4 total number of pages
출력될 페이지 번호 currentPage 10 Optional 1 Page number to be printed

Sample Code

Please check the sample code on your PC.