운송장번호와 택배사를 지정해 실시간 배송현황을 조회합니다. 결과를 DB에 저장하지 않고 매 호출마다 택배사 시스템을 즉시 조회하며, 운송장번호만 있고 택배사를 모를 때는 자동조회(/rest/parcel_tracking_auto)를 이용할 수 있습니다.
대형 택배사부터 편의점택배·당일배송·국제특송까지 한 번에 조회
결과를 저장하지 않고 매 호출마다 택배사 시스템을 즉시 조회
운송장번호만으로 형식을 분석해 최대 5개 후보 택배사를 동시 조회
/rest/parcel_tracking/rest/parcel_tracking_auto/rest/parcel_tracking_carriers택배사 조회에 실패(배송정보 없음, 택배사 시스템 오류 등)하면 과금되지 않습니다.
아래 carrier 코드를 요청 파라미터로 사용하세요. 자동조회(/rest/parcel_tracking_auto)는 carrier 없이 운송장번호만으로 조회합니다.
cjhanjinlottelogenepost_domestickdexpilyangkurlynextmiledboxcu_postboxdaesinslxwoori_deliveryyongmaletusdoobalherogeniegopingpongchunilkunyoungnhlogiswinionlogishdexptodaypickuponedaylogisvalexdrabbitcoupanglssunghwaems_internationalcj_internationalcainiao_global택배사 목록 조회(/rest/parcel_tracking_carriers)는 별도 파라미터가 필요 없습니다.
data.status와 각 events[].status는 아래 값 중 하나만 반환합니다. 택배사별 원문 문구는 carrierStatus에 그대로 담깁니다.
배송정보를 찾지 못했거나 조회에 실패하면 data.error(안내 문구)와 data.code(오류 코드)가 담기며 과금되지 않습니다. data.code는 아래 값 중 하나입니다.
개인정보 보호를 위해 수취인 이름·전화번호·상세주소 등은 응답에 포함되지 않습니다.
curl -k -X POST "https://apick.app/rest/parcel_tracking" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "carrier=cj" \
-F "trackingNumber=123456789012"
curl -k -X POST "https://apick.app/rest/parcel_tracking_auto" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "trackingNumber=123456789012"
{
"data": {
"carrier": { "code": "cj", "name": "CJ대한통운" },
"trackingNumber": "123456789012",
"status": "DELIVERED",
"carrierStatus": "배달완료",
"events": [
{ "time": "2026-08-01T09:00:00+09:00", "location": "서울", "status": "PICKED_UP", "carrierStatus": "집화완료", "description": "집화완료" },
{ "time": "2026-08-02T14:00:00+09:00", "location": "서울", "status": "DELIVERED", "carrierStatus": "배달완료", "description": "배달완료" }
],
"success": 1
},
"api": {
"success": true,
"cost": 5,
"ms": 1820,
"pl_id": 1595644
}
}