列出 Shipments（分頁）

​

僅在以下情況呼叫

• 一次性回填：首次整合時，於訂閱 webhook 之前，將既有運貨單寫入本地資料庫。
• 定期對帳：用以偵測遺漏或亂序的 webhook 傳遞——將本地快取與本端點結果比對，再透過 webhook 重發或客服單進行補齊。

​

必要參數

• createFrom / createTo — 均必填，ISO 8601 時間戳。範圍上限為 90 天（SearchConfig.simpleRecordsMaxDays），超出會傳回軟錯誤。
• pageSize — 介於 1 與 50 之間。
• offset — 非負整數。搭配 pageSize 用於位移分頁。

​

回應備註

• 總數不會回傳；當某頁回傳少於 pageSize 筆記錄時，即表示已到尾。
• labelRequestStatusCode 反映查詢當下的最新狀態。狀態變更歷史請改用 webhook 事件；本端點無法提供。
• 回應中的國家代碼為 ISO3。

​

相關

• 建立退件運貨單 — 寫入側端點。
• 取得所有運貨單狀態 — 將 shipmentStatusCode 轉譯為可讀標籤。
• Webhooks — 運貨單生命週期事件的標準通道。請先設定 webhook 再使用本端點。