Shipments 一覧（ページネーション付き）

​

呼び出してよいタイミング（それ以外では呼ばないでください）

• 一回限りのバックフィル — 初回統合時、webhook 購読の前にローカル DB に既存のシップメントを書き込むため。
• 定期的な整合性チェック — webhook 配信の漏れや順序ずれを検知するため。ローカルキャッシュとこのエンドポイントの結果を差分し、webhook 再送やサポート連携で穴埋めしてください。

​

必須パラメータ

• createFrom / createTo — どちらも必須、ISO 8601 タイムスタンプ。範囲は 90 日が上限（SearchConfig.simpleRecordsMaxDays）。それ以上はソフトエラーで拒否されます。
• pageSize — 1 から 50 の間。
• offset — 非負整数。pageSize と組み合わせてオフセットページングを行います。

​

レスポンスの注意

• 総件数は 返されません。あるページで pageSize 未満のレコードが返ってきたら、それが末尾です。
• labelRequestStatusCode はクエリ時点の最新状態を表します。状態遷移の履歴が必要な場合は webhook イベントを購読してください——本エンドポイントでは履歴を取得できません。
• レスポンスの国コードは ISO3 です。

​

関連

• 返品シップメントを作成 — 書き込み側エンドポイント。
• すべてのシップメントステータスを取得 — shipmentStatusCode を可読ラベルへ変換。
• Webhooks — シップメントライフサイクル イベントの正規チャネル。本エンドポイントを利用する前に必ず webhook を設定してください。