국제 배송 추적 API

지원되는 모든 번호로 조회

HioBuy 배송 ID를 모르는 경우 GET /v1/fulfillment/tracking?sn={sn}을 사용합니다. sn은 물류 번호(logistics_sn), 창고 주문 번호(order_sn) 또는 개발자가 제공한 외부 번호(client_order_sn)일 수 있습니다. HioBuy는 값을 변경하지 않고 전달하며 창고가 유형을 자동으로 판단합니다. 필요한 권한은 tracking:read입니다. API Key를 브라우저 코드에 포함하지 마세요.

GET /v1/fulfillment/shipments/{shipment_id}/tracking — warehouse → overseas recipient.

Not domestic procurement trace (seller → warehouse).
Not package tracking (HioBuy warehouse inbound timeline).
Not shipment detail: that response holds tracking numbers (international_tracking, shipping_legs[], boxes[].tracking) and warehouse business timeline[] (created / packed / paid). This route returns carrier scan events.

Path {shipment_id} accepts the HioBuy shipment id or the external_shipment_id supplied at create time. Numeric-only values are sent as shipment_id; any value containing a non-digit is sent as external_shipment_id. Prefix developer identifiers, for example shp_MY-ORDER-001.

Warehouse upstream: POST /api/gateway-worker/v1/shipments/track. Retired: POST /v1/fulfillment/shipments/logistics/trace.

Request

GET /v1/fulfillment/shipments/107/tracking?language=en
Authorization: Bearer <API_KEY>

Response

The response includes status, independent interception, and newest-first timeline[]. interception is null when no interception was requested; otherwise it reports the interception request state without replacing the shipment lifecycle status. Every event requires { code, status, title, occurred_at, details }; code is stable and non-null, occurred_at is timezone-aware ISO 8601, and details is {} when empty. Use code and status for program logic; title is localized display copy. Standard codes and interception semantics are documented in Shipments · timeline contract.