Shipments

List all shipments in paginated result

get
Authorizations
Query parameters
trackingNumbersstring[]Required
pageinteger · int32Optional

The page number to request (1 based)

Default: 1Example: 1
sizeinteger · int32Optional

The number of results to return in a page

Default: 10Example: 10
Responses
200
OK
application/json
get
GET /api/shipments HTTP/1.1
Host: apipub.firstbasehq.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "size": 1,
    "totalElements": 1,
    "totalPages": 1,
    "pageNumber": 1,
    "data": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "trackingCode": "1Z00000000",
        "carrier": "UPS",
        "status": "DELIVERED",
        "trackingHistory": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "status": "IN_TRANSIT",
            "createdAt": "2025-07-27T20:41:35.121Z"
          }
        ],
        "createdAt": "2025-07-27T20:41:35.121Z",
        "orderItemIds": "[123E4567-E89B-12D3-A456-426614174000, 123E4567-E89B-12D3-A456-426614175000]",
        "trackingUrl": "http://trackinglink.com/trackingcode"
      }
    ]
  }
]
PreviousOrdersNextPackages