> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eazecustoms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List shipments

> Returns a paginated list of shipments.

Returns a paginated list of shipments. Filter by status or reference numbers.

### Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number (1-indexed).
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Items per page (max 100).
</ParamField>

<ParamField query="status" type="string">
  Filter by shipment status. Allowed values: `new`, `clearanceInProgress`, `completed`.
</ParamField>

<ParamField query="referenceNumber" type="string">
  Filter by shipment reference number.
</ParamField>

<ParamField query="dateFrom" type="string">
  Created on or after (YYYY-MM-DD).
</ParamField>

<ParamField query="dateTo" type="string">
  Created on or before (YYYY-MM-DD).
</ParamField>

<ParamField query="sortOrder" type="string" default="desc">
  Sort order (`asc` or `desc`).
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "page": 1,
    "itemsPerPage": 20,
    "itemCount": 56,
    "result": [
      {
        "shipmentId": 99,
        "referenceNumber": "180-43189021",
        "status": "clearanceInProgress",
        "createdAt": "2026-06-10T08:30:00.000Z",
        "updatedAt": "2026-06-10T08:31:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>