배송조회 (GET)

택배사 code와 운송장 번호로 현재 배송 상태를 조회합니다.

요청

Parameter	위치	필수	설명
`t_key`	query	예	발급받은 API 키 원문
`t_code`	query	예	company list의 택배사 code
`t_invoice`	query	예	ASCII 숫자로 된 운송장 번호, 최대 64자

curl --get "$TAEKMANI_BASE_URL/api/v1/trackingInfo" \
  --data-urlencode "t_key=$TAEKMANI_API_KEY" \
  --data-urlencode "t_code=04" \
  --data-urlencode "t_invoice=000000000000" \
  --header "Accept: application/json"

JSON 응답 예시

{
  "adUrl": null,
  "complete": false,
  "invoiceNo": "000000000000",
  "itemImage": null,
  "itemName": "합성 상품",
  "level": 3,
  "receiverAddr": "",
  "receiverName": "수*",
  "recipient": "",
  "result": "Y",
  "senderName": "발*",
  "trackingDetails": [
    {
      "kind": "합성 배송 상태",
      "level": 3,
      "manName": "",
      "manPic": "",
      "telno": "",
      "telno2": "",
      "time": 1767236400000,
      "timeString": "2026-01-01 12:00:00",
      "where": "합성 물류 지점",
      "code": null,
      "remark": null
    }
  ],
  "orderNumber": null,
  "estimate": null,
  "productInfo": null,
  "zipCode": null,
  "lastDetail": {
    "kind": "합성 배송 상태",
    "level": 3,
    "manName": "",
    "manPic": "",
    "telno": "",
    "telno2": "",
    "time": 1767236400000,
    "timeString": "2026-01-01 12:00:00",
    "where": "합성 물류 지점",
    "code": null,
    "remark": null
  },
  "lastStateDetail": {
    "kind": "합성 배송 상태",
    "level": 3,
    "manName": "",
    "manPic": "",
    "telno": "",
    "telno2": "",
    "time": 1767236400000,
    "timeString": "2026-01-01 12:00:00",
    "where": "합성 물류 지점",
    "code": null,
    "remark": null
  },
  "firstDetail": {
    "kind": "합성 배송 상태",
    "level": 3,
    "manName": "",
    "manPic": "",
    "telno": "",
    "telno2": "",
    "time": 1767236400000,
    "timeString": "2026-01-01 12:00:00",
    "where": "합성 물류 지점",
    "code": null,
    "remark": null
  },
  "completeYN": "N"
}

XML 응답 예시

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tracking_info>
  <complete>false</complete>
  <invoice_no>000000000000</invoice_no>
  <item_name>합성 상품</item_name>
  <level>3</level>
  <reciver_addr></reciver_addr>
  <reciver_name>수*</reciver_name>
  <recipient></recipient>
  <result>Y</result>
  <sender_name>발*</sender_name>
  <tracking_details>
    <trans_kind>합성 배송 상태</trans_kind>
    <level>3</level>
    <manName></manName>
    <manPic></manPic>
    <trans_telno></trans_telno>
    <trans_telno2></trans_telno2>
    <trans_time>2026-01-01 12:00:00</trans_time>
    <timeString>2026-01-01 12:00:00</timeString>
    <trans_where>합성 물류 지점</trans_where>
  </tracking_details>
  <complete>N</complete>
</tracking_info>

result가 N이면 아직 조회되지 않은 운송장일 수 있으며 HTTP 응답은 성공입니다. 오류 102~106도 HTTP 200이므로 오류 처리를 함께 구현하세요.

상태 코드

HTTP	설명
`200`	배송 결과 또는 업무 오류 `102`~`106`
`400`	오류 `101`: API 키 누락 또는 무효
`406`	지원하지 않는 응답 형식
`500`	내부 오류, body 없음

요청

JSON 응답 예시

XML 응답 예시

상태 코드

On this page