荷物追跡API

無料で始める

配送会社

日本郵便・ゆうパックの追跡を荷物追跡APIで取得する

2026.07.04・読了約6分

荷物追跡APIを使えば、日本郵便（ゆうパック・ゆうパケット）のお問い合わせ番号から配送状況をプログラムで取得できます。この記事では、日本郵便の追跡を取得する方法を解説します。

日本郵便の配送会社コード

荷物追跡APIで日本郵便を指定するには、courierCode に post を指定します。ゆうパック・ゆうパケット・レターパックなど、日本郵便の追跡番号に対応しています。

リクエスト

curl https://api.trackingapi.jp/v1/tracking/trace \
  -H "Authorization: Bearer pk_***:sk_***" \
  -H "Content-Type: application/json" \
  -d '{ "items": [{ "courierCode": "post", "trackingNumber": "お問い合わせ番号" }] }'

レスポンス

日本郵便の「引受」「中継」「到着」「お届け先にお届け済み」といった配送履歴を、荷物追跡APIが統一フォーマットで返します。

"data": {
  "courierName": "日本郵便",
  "deliveryStatus": "DELIVERED",
  "deliveryStatusText": "配達完了",
  "isDelivered": true,
  "progresses": [
    { "status": "引受", "deliveryStatus": "PICKED_UP" },
    { "status": "中継", "deliveryStatus": "IN_TRANSIT" },
    { "status": "お届け先にお届け済み", "deliveryStatus": "DELIVERED" }
  ]
}

複数の配送会社をまとめて扱う

荷物追跡APIでは、日本郵便・ヤマト運輸・佐川急便を同じ形式で扱えます。ネットショップのように複数の配送会社を使う場合でも、ひとつのAPIで配送状況表示を実装できます。

関連リンク

荷物追跡APIを無料で試す

月10,000件まで無料。追跡番号を送るだけで配送状況が返ります。

無料で始めるドキュメント