Skip to main content
POST
/
v1
/
declarations
/
bulk
Bulk create declarations
curl --request POST \
  --url https://devapi.eazecustoms.com/staging/v1/declarations/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "declarations": [
    {}
  ]
}
'
{
  "results": [
    {
      "success": true,
      "referenceNumber": "IMP-2026-01001",
      "declarationId": 45,
      "shipmentId": 18,
      "status": "processing",
      "lrn": "NL202600005"
    },
    {
      "success": false,
      "referenceNumber": "IMP-2026-01002",
      "errors": [
        "DeclarationItems.0.commodityCode must be a valid HS code"
      ]
    }
  ]
}
Create multiple import declarations in one request. Processing is partial-success: valid items are created even if others fail.

​
Request Payload

​
declarations
array
required
List of declaration payloads to create in bulk. Each item in the array must follow the simplified IMPORT or full declaration schema.

​
Response

The response returns an array containing the creation results for each submitted declaration. You should inspect the success field for each item in the list to verify if it was successfully created or encountered validation errors. 
{
  "results": [
    {
      "success": true,
      "referenceNumber": "IMP-2026-01001",
      "declarationId": 45,
      "shipmentId": 18,
      "status": "processing",
      "lrn": "NL202600005"
    },
    {
      "success": false,
      "referenceNumber": "IMP-2026-01002",
      "errors": [
        "DeclarationItems.0.commodityCode must be a valid HS code"
      ]
    }
  ]
}