API ReferenceShipmentsList the authenticated account's shipments

List the authenticated account's shipments

GET/api/v1/shipments

Cursor-based pagination. Filters: status, updated_after. Slim list-view shape — call /v1/shipments/{id} for full detail with events.

Parameters

limit

integerquery

cursor

stringquery

Opaque cursor from a previous response's next_cursor field.

status

stringquery

updated_after

stringquery

Responses

Success body

{
  "status": 200,
  "message": "OK",
  "data": {
    "data": [
      {
        "id": "IM-2026-0528-9ZNCP3-1",
        "status": "label_created",
        "service_tier": "HKASTDGGSTCM",
        "destination_country": "US",
        "livemode": false,
        "created_at": "2026-05-28T07:44:23.908Z",
        "delivered_at": null
      }
    ],
    "next_cursor": null
  }
}

Returned object

Field	Type	Sample