20.1. logis/status GET

주문[Order] 또는 출고박스[OutBox]의 배송 상태를 조회

API KEY를 보유한 유저 조회 가능

GET[DOMAIN]/api/logis/status/?trackingNumber={trackingNumber}

• trackingNumber: 조회할 송장번호 [주문 번호(bulkNumber), 정제된 박스코드(boxCode)]
• Headers: Api-Key: {APIKEY}

호출 결과 코드

status	err_code	설명
SUCCESS		성공
FAIL	NO_TRACKING_NUMBER	송장번호[주문 번호(bulkNumber), 정제된 박스코드(boxCode)] 입력 누락
FAIL	NOT_FOUND	해당 송장번호 정보 미존재

반환값 (results)

파라미터 명	필수	데이터 타입	값	비고
type		String	order: 입고 주문건 / outbox: 출고 건
trackingNumber	필수	String	송장번호 [주문 번호, 정제된 박스코드]	입고 운송장 번호 [12자리]: YYMMDD000000 (YYMMDD: 연월일, 000000: 숫자) / 출고 운송장 번호 [13자리]: CYYMMDD000000 (C: 알파벳 대문자 C)
boxCode		String	출고 주문의 경우 박스코드
statuses		String	현재 상태	주문 상태 코드 참조
statusesHistory		List	상태 변경 이력	각 항목: statuses (과거 상태값), createdAt (과거 상태값으로 변경된 시각)

호출 결과 예시

{
    "status": "SUCCESS",
    "results": {
        "type": "order",
        "trackingNumber": "20250605000686",
        "statuses": "inspected",
        "statusesHistory": [
            {"statuses": "placed", "createdAt": "2025-06-05T06:55:22.455404Z"},
            {"statuses": "inspecting", "createdAt": "2025-06-05T07:13:03.449585Z"},
            {"statuses": "inspected", "createdAt": "2025-06-17T04:53:35.736029Z"}
        ]
    }
}