Skip to main content
GET
/
v1
/
declarations
List import declarations
curl --request GET \
  --url https://sandbox-api.easecustoms.com/v1/declarations \
  --header 'Authorization: Bearer <token>'
{
  "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"
    }
  ]
}
Returns a paginated list of declarations. Use query parameters to filter or sort the results.

​
Query Parameters

​
page
integer
default:"1"
Page number (1-indexed)
​
limit
integer
default:"20"
Items per page (max 100)
​
status
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.
​
referenceNumber
string
Filter by shipment reference number (partial match).
​
dateFrom
string
Only include declarations created on or after this date (YYYY-MM-DD).
​
dateTo
string
Only include declarations created on or before this date (YYYY-MM-DD).
​
sortOrder
string
default:"desc"
Sort order by creation date (asc or desc).
{
  "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"
    }
  ]
}