> ## 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 import declarations

> Returns a paginated list of import declarations with optional filters.

Returns a paginated list of declarations. Use query parameters to filter or sort the results.

### 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 declaration status. Allowed values: `processing`, `ready`, `submitted`, `registered`, `under_control`, `accepted`, `released`, `tax_notice`, `invalid`, `error`, `completed`, `canceled`, `cancellation_requested`, `non_exited`, `exited`, `amendment_requested`, `no_release`.
</ParamField>

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

<ParamField query="dateFrom" type="string">
  Only include declarations created on or after this date (YYYY-MM-DD).
</ParamField>

<ParamField query="dateTo" type="string">
  Only include declarations created on or before this date (YYYY-MM-DD).
</ParamField>

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "page": 1,
    "itemsPerPage": 20,
    "itemCount": 134,
    "result": [
      {
        "declarationId": 42,
        "shipmentId": 15,
        "referenceNumber": "180-43189021",
        "status": "ready",
        "lrn": "NL202600001",
        "mrn": "26NL90831023812038",
        "type": "IMPORT",
        "declarationOffice": "NL000850",
        "createdAt": "2026-06-10T08:30:00.000Z",
        "updatedAt": "2026-06-10T08:31:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>