대신택배 조회 API

대신택배 소개

대신택배(DS Express)는 소화물 배송을 전문으로 하는 택배사로, 특히 지방 및 도서산간 지역 배송에 강점을 가지고 있습니다. 전국 네트워크를 통해 안정적인 배송 서비스를 제공하며, 중소 쇼핑몰과 개인 발송자들이 많이 이용합니다.

송장번호 형식

대신택배 송장번호는 10~13자리 숫자로 구성됩니다. 인쇄된 송장에는 하이픈(-)이 포함된 형식으로 표기되는 경우가 있지만, API 조회 시에는 숫자만 입력해야 합니다.

항목	내용
자릿수	10~13자리
구성	숫자 (하이픈 제외)
표기 예시 (인쇄)	123-456-7890
API 입력 형식	1234567890

API 연동 예시

택배조회API는 단일 엔드포인트로 대신택배를 포함한 모든 택배사 조회를 지원합니다. courierCode에 "daesin"을 지정하면 됩니다.

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": "daesin",
        "trackingNumber": "1234567890"
      }
    ]
  }'

응답 예시

{
  "isSuccess": true,
  "data": {
    "results": [
      {
        "success": true,
        "data": {
          "courierCode": "daesin",
          "courierName": "대신택배",
          "trackingNumber": "1234567890",
          "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는 대신택배의 내부 상태 코드를 표준화된 상태 코드로 변환하여 반환합니다. 모든 택배사에 동일한 상태 코드 체계가 적용되므로 연동이 간편합니다.

상태 코드	상태 레이블	설명
PENDING	접수	송장 발행 후 물건 인수 전 상태
PICKED_UP	집하 완료	물건을 집하하여 터미널로 이동 중
IN_TRANSIT	배송 중	터미널 간 간선 이동 또는 배송 준비 중
OUT_FOR_DELIVERY	배달 중	배달 기사가 수취인에게 배달 중
DELIVERED	배송 완료	수취인에게 배달 완료

FAQ

대신택배 송장번호가 조회되지 않습니다.

대신택배는 집하 완료 이후 시스템에 배송 정보가 등록됩니다. 송장 발행 직후에는 조회되지 않을 수 있으며, 물건 접수 후 수 시간이 지난 뒤 다시 조회해 보세요. 그래도 조회되지 않는다면 고객센터(1588-4321)로 문의하시기 바랍니다.

하이픈이 포함된 송장번호를 그대로 입력해도 되나요?

API 요청 시에는 하이픈을 제거하고 숫자만 입력해야 합니다. 예를 들어 123-456-7890은 1234567890으로 변환하여 trackingNumber 필드에 전달하세요.

대신택배를 포함해 여러 택배사를 한 번에 조회할 수 있나요?

네, 가능합니다. items 배열에 여러 송장 정보를 담아 요청하면 단일 API 호출로 복수의 택배사 송장을 동시에 조회할 수 있습니다. 자세한 내용은 API 문서를 참고하세요.

배송 상태가 오래 업데이트되지 않습니다.

대신택배 시스템의 업데이트 주기에 따라 배송 이력이 지연될 수 있습니다. 이상이 지속될 경우 대신택배 고객센터(1588-4321)에 직접 문의하시는 것이 빠릅니다.