---
title: "배송사 운송장번호별 주문 상태 조회 (One)"
method: GET
path: "/v1/order/status/transporterInvoiceNo/{transporterInvoiceNo}"
tags: ["3. Order"]
---

# 배송사 운송장번호별 주문 상태 조회 (One)

`GET /v1/order/status/transporterInvoiceNo/{transporterInvoiceNo}`

배송사 운송장번호(홈픽택배,한진택배)에 해당하는 주문 상태값을 조회합니다.
- transporterInvoiceNo 를 먼저 조회하고, 검색 결과가 없을 경우 relayTransporterInvoiceNo 룰 조회합니다.

## Path parameters

- `transporterInvoiceNo` string, required

## Response `200`

성공

- JFSOrderStatusHistoryItemSimpleBoxDTO — 주문(박스) 상태 조회 응답
  - `success` boolean — 성공여부
  - `message` string — 메시지
  - `data` OrderStatusHistoryItemSimpleBoxDTO — 주문 상태 조회 응답-data
    - `orderNo` string — 주문 번호
    - `invoiceNo` string — 박스(운송장) 번호
    - `transporter` 'HANJIN,CUHOME,EPOST,CJGLS' — 배송사 코드
    - `transporterInvoiceNo` string — 배송사 송장번호
    - `relayTransporter` 'HANJIN,CUHOME,EPOST,CJGLS' — 연계배송사 코드
    - `relayTransporterInvoiceNo` string — 연계배송사 운송장번호
    - `partnerOrderNo` string — 제휴사 주문번호
    - `partnerInvoiceNo` string — 제휴사 운송장번호
    - `partnerMemo` string — 제휴사 메모
    - `statusList` OrderStatusHistoryItemSimpleDTO[] — 주문 상태 이력 리스트
      - `createdDateTime` string — 상태 생성일시
      - `orderStatus` 'RESERVED' | 'RESERVED_CANCELED' | 'RECEIVED' | 'TRANSFERRED' | 'ALLOCATED' | 'PICKUP_START' | 'PICKUP_FAILED' | 'PICKUP' | 'MOVING' | 'DLV_START' | 'WAYPOINT_ARRIVAL' | 'COMPLETED' | 'CANCELED' — 주문상태
      - `orderStatusName` '예약' | '예약취소' | '접수완료' | '이관' | '배차' | '픽업출발' | '미픽업' | '픽업완료' | '이동중' | '배송출발' | '경유지도착' | '배송완료' | '취소' — 주문상태명
      - `orderStatusDateTime` string — 상태 일시
      - `location` string — 현재 위치(지점)
      - `tmsStatusName` string — 배송사 상태명
      - `driverName` string — 기사명
      - `driverPhoneNumber` string — 기사 연락처
      - `reasonType` string — 사유(픽업/배송)
      - `contents` string — 사유텍스트
    - `completedOrCanceled` boolean — 배송 종결 여부(배송완료 또는 취소). true 면 상태가 더 바뀌지 않으므로 재조회할 필요가 없다. 배송완료 이후에도 추가운임은 붙을 수 있어 '금액 확정'을 뜻하지는 않는다.
    - `costChangeHistory` OrderBoxCostChangeHistoryDTO[] — 추가요금 이력 리스트
      - `id` string
      - `changedAmount` integer
      - `reason` string
      - `createdDateTime` string, date-time
    - `boxCost` integer — 박스금액
    - `addedCost` integer — 추가금액
    - `cancelAmount` integer — 취소금액
    - `cart` boolean
  - `responseDateTime` string, date-time — 응답 서버 시간

## Changes

- **2026-09-07** `bec7a1780b65` — 1 info
  - added the optional property `data/completedOrCanceled` to the response with the `200` status

[Change history](https://skmtc.dev/homepick/apis/homepick-api/changes/v1/order/status/transporterInvoiceNo/:transporterInvoiceNo/get.md)

---

[API](https://skmtc.dev/homepick/apis/homepick-api.md) · [All operations](https://skmtc.dev/homepick/apis/homepick-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homepick/apis/homepick-api/revisions/8fe77d7f142f?raw)