Shipments

Get shipment tracking

Read stored tracking status and events, oldest first. Requests do not trigger a carrier refresh. Poll every 1–5 minutes within your rate limit. See Tracking for normalized event types and timestamp semantics.

get/api/external/v1/shipments/{shipment_id}/tracking

Request

  • Base URL: http://localhost
  • URL: http://localhost/api/external/v1/shipments/{shipment_id}/tracking
  • Auth: HTTP bearer

Response

Example response

{
  "data": {
    "shipment_id": "shp_x7Kq9",
    "tracking_number": "PN123456789SE",
    "tracking_url": "https://tracking.example/PN123456789SE",
    "status": "in_transit",
    "last_event_at": "2026-05-27T18:05:00Z",
    "events": [
      {
        "status": "SHIPMENT_CREATED",
        "description": "Shipment information received",
        "location": {
          "city": "Göteborg",
          "country": "SE"
        },
        "occurred_at": "2026-05-27T10:05:00Z"
      },
      {
        "status": "PICKED_UP",
        "description": "Collected by the carrier",
        "location": {
          "city": "Göteborg",
          "country": "SE"
        },
        "occurred_at": "2026-05-27T12:35:00Z"
      },
      {
        "status": "IN_TRANSIT",
        "description": "Departed sorting facility",
        "location": {
          "city": "Göteborg",
          "country": "SE"
        },
        "occurred_at": "2026-05-27T18:05:00Z"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.