쿠팡택배 조회 API

쿠팡택배 소개

쿠팡로지스틱스서비스(CLS)는 쿠팡이 자체 구축한 풀필먼트 및 라스트마일 배송 네트워크입니다. 전국의 캠프(터미널)와 전담 배송 기사 네트워크를 통해 로켓배송, 새벽배송, 당일배송 서비스를 제공합니다. 일반 쇼핑몰 출고 및 3PL 고객사도 쿠팡택배를 이용할 수 있으며, 배송 상태는 API로 실시간 조회가 가능합니다.

송장번호 형식

쿠팡택배의 송장번호는 주로 14자리 숫자로 구성됩니다. 일부 건에 따라 10~16자리 범위로 발급되는 경우도 있습니다.

구분	내용
기본 자릿수	14자리
허용 범위	10~16자리
구성	숫자만 사용 (하이픈 없음)
예시	12345678901234

API 연동 예시

택배조회API에서 쿠팡택배를 조회할 때는 POST /v1/tracking/trace 엔드포인트에 courierCode: "coupang"을 지정합니다. 한 번의 요청으로 여러 송장번호를 일괄 조회할 수 있습니다.

요청 예시 (curl)

curl -X POST https://api.deliveryapi.co.kr/v1/tracking/trace \
  -H "Authorization: Bearer {YOUR_API_KEY}:{YOUR_SECRET_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "courierCode": "coupang",
        "trackingNumber": "12345678901234"
      }
    ]
  }'

응답 예시

{
  "isSuccess": true,
  "data": {
    "results": [
      {
        "success": true,
        "data": {
          "courierCode": "coupang",
          "courierName": "쿠팡택배",
          "trackingNumber": "12345678901234",
          "deliveryStatus": "DELIVERED",
          "deliveryStatusText": "배송완료",
          "isDelivered": true,
          "progresses": [
            {
              "dateTime": "2026-03-11T09:00:00+09:00",
              "status": "집하",
              "statusCode": "PICKED_UP",
              "location": "수원캠프",
              "description": "집하 완료"
            },
            {
              "dateTime": "2026-03-11T13:30:00+09:00",
              "status": "캠프도착",
              "statusCode": "IN_TRANSIT",
              "location": "서울강남캠프",
              "description": "캠프 도착"
            },
            {
              "dateTime": "2026-03-11T15:00:00+09:00",
              "status": "배송출발",
              "statusCode": "OUT_FOR_DELIVERY",
              "location": "서울강남캠프",
              "description": "배송 출발"
            },
            {
              "dateTime": "2026-03-11T18:22:00+09:00",
              "status": "배송완료",
              "statusCode": "DELIVERED",
              "location": "서울 강남구",
              "description": "배송이 완료되었습니다."
            }
          ],
          "dateLastProgress": "2026-03-11T18:22:00+09:00",
          "queriedAt": "2026-03-11T19:00:00+09:00"
        }
      }
    ],
    "summary": { "total": 1, "successful": 1, "failed": 0, "billable": 1 }
  }
}

배송 상태 코드 매핑

택배조회API는 쿠팡택배의 내부 상태를 표준 상태 코드로 변환하여 반환합니다.

DeliveryAPI 상태	상태 레이블	설명
PENDING	접수	송장이 등록되었으나 아직 집하되지 않은 상태
PICKED_UP	집하완료	발송지에서 쿠팡 캠프로 화물이 입고된 상태
IN_TRANSIT	배송중	배송지 인근 캠프에 도착하여 배송 준비 중인 상태
OUT_FOR_DELIVERY	배송출발	담당 배송 기사가 수령인에게 출발한 상태
DELIVERED	배송완료	수령인에게 물품이 전달 완료된 최종 상태

자주 묻는 질문 (FAQ)

쿠팡택배 송장번호는 어디서 확인하나요?

쿠팡에서 주문한 경우 쿠팡 앱 또는 웹사이트의 주문 내역 페이지에서 송장번호를 확인할 수 있습니다. 판매자 발송 건의 경우 발송 확인 문자나 이메일에서 확인 가능합니다.

조회 결과가 바로 나오지 않아요

집하 처리 직후에는 시스템 반영까지 수십 분에서 최대 수 시간이 소요될 수 있습니다. 송장번호 입력 후 조회가 되지 않는다면 잠시 후 다시 시도하세요.

로켓배송과 일반 쿠팡택배의 API 코드가 동일한가요?

네, 로켓배송과 일반 쿠팡택배 모두 동일하게 courierCode: "coupang"을 사용합니다. 배송 서비스 유형에 따라 상태 업데이트 속도에 차이가 있을 수 있습니다.

여러 쿠팡 송장번호를 한 번에 조회할 수 있나요?

네, items 배열에 여러 항목을 담아 한 번의 API 요청으로 복수 건을 일괄 조회할 수 있습니다. 요청당 처리 가능한 최대 건수는 API 문서를 참고하세요.