경동택배 조회 API 연동 가이드

경동택배 소개

경동택배는 전국 물류망을 갖춘 종합 택배사로, 특히 지방 도서산간 지역 배송과 농산물·신선식품 전문 배송 서비스로 알려져 있습니다. 공식 배송조회 페이지는 kdexp.com에서 이용할 수 있으며, 고객센터 전화번호는 080-873-2178입니다.

송장번호 형식

경동택배 송장번호는 10자리에서 13자리 숫자로 구성됩니다. 하이픈(-)이나 공백 없이 숫자만 입력해야 합니다.

항목	내용
자릿수	10 ~ 13자리 (가변 길이)
구성	숫자만 (하이픈 제외)
예시 (10자리)	1234567890
예시 (13자리)	1234567890123

API 연동 예시

택배조회 API에서 경동택배 배송 정보를 조회하려면 courierCode를 kyungdong으로 지정하여 POST /v1/tracking/trace 엔드포인트를 호출합니다. 한 번의 요청으로 여러 송장번호를 동시에 조회할 수 있습니다.

요청 예시 (curl)

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

응답 예시

{
  "isSuccess": true,
  "data": {
    "results": [
      {
        "success": true,
        "data": {
          "courierCode": "kyungdong",
          "courierName": "경동택배",
          "trackingNumber": "1234567890123",
          "deliveryStatus": "DELIVERED",
          "deliveryStatusText": "배송완료",
          "isDelivered": true,
          "progresses": [
            {
              "dateTime": "2026-03-11T14:30:00+09:00",
              "status": "배달완료",
              "statusCode": "DELIVERED",
              "location": "수원지점",
              "description": "배달완료"
            }
          ],
          "dateLastProgress": "2026-03-11T14:30:00+09:00",
          "queriedAt": "2026-03-11T15:00:00+09:00"
        }
      }
    ],
    "summary": { "total": 1, "successful": 1, "failed": 0, "billable": 1 }
  }
}

배송 상태 코드 매핑

경동택배의 내부 상태 코드는 API 응답의 deliveryStatus 필드에서 표준화된 값으로 변환됩니다. 아래 표는 경동택배 원본 코드와 API 표준 상태 간의 매핑입니다.

경동택배 코드	원본 명칭	API 표준 상태	설명
0002	발송/집하	PICKED_UP	택배사가 물건을 수거한 상태
0003	이동중	IN_TRANSIT	터미널 간 이동 중인 상태
0004	간선상차	IN_TRANSIT	간선 차량에 적재된 상태
0005	간선하차	IN_TRANSIT	간선 차량에서 하차한 상태
0006	도착	OUT_FOR_DELIVERY	배송 지점 터미널에 도착한 상태
0007	인수확인/배달완료	DELIVERED	수령인에게 전달 완료된 상태
0008	배송출발	OUT_FOR_DELIVERY	배송 기사가 배송을 시작한 상태

자주 묻는 질문 (FAQ)

경동택배 송장번호가 조회되지 않아요

택배 접수 직후에는 시스템에 등록되기까지 수 시간이 소요될 수 있습니다. 접수 후 2~4시간 후에 다시 조회해보세요. 집하(0002) 상태가 확인되면 정상 추적이 가능합니다.

courierCode 값이 정확히 무엇인가요?

경동택배의 API 택배사 코드는 kyungdong입니다. 대소문자를 구분하므로 반드시 소문자로 입력해야 합니다.

신선식품 배송도 API로 조회할 수 있나요?

네, 경동택배의 신선식품 및 농산물 배송도 동일한 API 엔드포인트로 조회할 수 있습니다. 배송 특성상 당일 배송이 많아 상태 변화가 빠를 수 있습니다.

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

items 배열에 여러 객체를 포함하면 한 번의 요청으로 여러 송장번호를 조회할 수 있습니다. 다른 택배사의 송장번호도 같은 요청에 함께 포함할 수 있습니다.