이 누리집은 대한민국 공식 전자정부 누리집입니다.
XML
과학기술정보통신부 우정사업본부_국내우편물 종적 조회 서비스
QuickAISummary
오픈 API 정보
데이터 오류·개선 의견이 있으신가요?
기본 정보
-
OpenAPI 명
과학기술정보통신부 우정사업본부_국내우편물 종적 조회 서비스
-
분류체계
교통및물류 - 물류등기타
- 제공기관
-
관리부서명
우정사업정보센터 인터넷우체국팀
-
관리부서 전화번호
상세 및 제공정보
-
설명
우체국 등기번호(13자리)를 이용하여 건별 국내등기우편물의 배송내역을 조회하는 OPEN API 서비스입니다. ㅇ 출력하는 항목(사용자가 응답 받게 되는 데이터) : 발송인, 수취인, 등기번호, 우편물종류, 취급구분, 배달일자, 배달상태, 종적목록(날짜, 시간, 현재위치, 처리현황, 상세설명) 이 문서는 우정사업본부의 국내우편물 배송조회 서비스를 공공데이터 오픈API 형태로 제공하기 위한 기술 명세서로, 서비스 개요와 오퍼레이션 구성, 건별 국내우편물 등기 종적조회 기능에 대한 상세 내용을 포함합니다. 특히, 각 오퍼레이션별 요청 및 응답 메시지 구조와 항목 정의를 중심으로 구성되어 있으며, API 호출 시 필요한 데이터 형식과 처리 방식에 대한 기준을 제공합니다. 또한, 개발자가 배송조회 기능을 시스템에 연동할 수 있도록 요청·응답 메시지 명세를 명확히 제시하고, 국내우편물의 배송 상태를 조회하기 위한 핵심 기능과 데이터 흐름을 이해할 수 있도록 지원합니다. 이를 통해 배송추적 서비스 구현 시 필요한 기술적 기준을 제공하고, 안정적인 데이터 연동 및 활용이 가능하도록 돕는 규격서 역할을 수행합니다.
-
API 유형
REST
-
데이터 포맷
XML
-
공간범위
-
-
시간범위
-
-
키워드
경제경영,마케팅,물류유통관리,배송조회,등기번호,보낸사람,배달상태,우체국
-
활용신청 수
882
-
등록일
2011-12-03
-
수정일
2026-07-28
이용 조건 및 라이선스 정보
-
비용부과유무
무료
-
이용허락범위
공공저작물 : 출처표시 (제 1유형)
-
심의유형
개발단계 : 자동승인 / 운영단계 : 자동승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
참고문서
-
국내우편물 배송조회서비스 명세서.docx
표준 메타데이터
활용 정보
API 서비스
등기번호를 기준으로 발송인명, 수취인명, 등기번호, 우편물종류, 취급구분, 배달일자, 배달상태, 종적목록, 날짜, 시간, 현재위치, 처리현황, 상세설명을 출력해주는 국내등기종적조회 서비스
API 기본 정보
-
활용승인 절차
개발단계 : 자동승인 / 운영단계 : 자동승인
-
신청 가능 트래픽
개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
-
요청주소
-
서비스 URL
http://openapi.epost.go.kr/trace/retrieveLongitudinalService/retrieveLongitudinalService/getLongitudinalDomesticList
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 등기번호 | rgist | 15 | 필수 | 1111111111111 | 등기번호 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 발송인 | applcntNm | 50 | 필수 | 홍*동 | 발송인명 |
| 수취인 | addrseNm | 50 | 필수 | 홍*동 | 수취인명 |
| 등기번호 | rgist | 15 | 필수 | 6897102086554 | 등기번호 |
| 우편물종류 | pstmtrKnd | 10 | 필수 | 소포 | 우편물종류 |
| 취급구분 | trtmntSe | 20 | 옵션 | 익일특급 | 취급구분(익일특급만 제공) |
| 배달일자 | dlvyDe | 8 | 옵션 | 2010.09.02 | 배달일자(yyyy.mm.dd) |
| 배달상태 | dlvySttus | 20 | 옵션 | 배달완료 | 배달상태 |
| 날짜 | dlvyDate | 8 | 필수 | 2010.09.02 | 날짜(yyyy.mm.dd) |
| 시간 | dlvyTime | 4 | 필수 | 19:29 | 시간(xx:yy) |
| 현재위치 | nowLc | 30 | 필수 | 동서울우편집중국 | 현재위치 |
| 처리현황 | processSttus | 20 | 필수 | 배달준비 | 처리현황 |
| 상세설명 | detailDc | 100 | 옵션 | 수취인 부재배달중 | 상세설명 |