Skip to main content
POST
/
v1
/
declarations
Submit an import declaration
curl --request POST \
  --url https://sandbox-api.easecustoms.com/v1/declarations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Shipment": {
    "shipmentNo": "<string>",
    "shipmentType": "<string>",
    "remarks": "<string>"
  },
  "commercialReference": "<string>",
  "procedureType": "<string>",
  "declarationType": "<string>",
  "additionalDeclarationType": "<string>",
  "representation": "<string>",
  "declarationOffice": "<string>",
  "goodsLocationType": "<string>",
  "goodsLocationAddressType": "<string>",
  "goodsLocationAddress": {
    "Address": {
      "houseNo": "<string>",
      "street": "<string>",
      "city": "<string>",
      "countryCode": "<string>",
      "postCode": "<string>"
    }
  },
  "countryOfDestination": "<string>",
  "arrivalTransportType": "<string>",
  "arrivalTransportNameType": "<string>",
  "arrivalTransportName": "<string>",
  "borderTransportType": "<string>",
  "invoiceCurrency": "<string>",
  "incoterm": "<string>",
  "incotermLocation": "<string>",
  "Consignee": {
    "name": "<string>",
    "street": "<string>",
    "houseNo": "<string>",
    "city": "<string>",
    "state": "<string>",
    "stateRegion": "<string>",
    "postcode": "<string>",
    "countryCode": "<string>",
    "eoriNo": "<string>",
    "vatNo": "<string>",
    "iossNo": "<string>"
  },
  "Consignor": {
    "name": "<string>",
    "street": "<string>",
    "houseNo": "<string>",
    "city": "<string>",
    "state": "<string>",
    "stateRegion": "<string>",
    "postcode": "<string>",
    "countryCode": "<string>",
    "eoriNo": "<string>",
    "vatNo": "<string>",
    "iossNo": "<string>"
  },
  "SupportingDocuments": [
    {
      "typeCode": "<string>",
      "description": "<string>"
    }
  ],
  "AdditionalInformations": [
    {
      "typeCode": "<string>",
      "description": "<string>"
    }
  ],
  "DeclarationItems": [
    {
      "description": "<string>",
      "commodityCode": "<string>",
      "quantity": 123,
      "grossMass": 123,
      "netWeight": 123,
      "netPrice": 123,
      "currency": "<string>",
      "originCountry": "<string>",
      "supplementaryQuantity": 123,
      "supplementaryQuantityUnit": "<string>",
      "additionalProcedureCodes": "<string>",
      "SupportingDocuments": [
        {}
      ]
    }
  ]
}
'
{
  "declarationId": 42,
  "shipmentId": 15,
  "referenceNumber": "INV-2026-07001",
  "status": "processing",
  "lrn": "NL202600001"
}
Creates and queues a new import customs declaration. Validation runs asynchronously — status will move from processing → ready once complete.

​
Request Payload

​
Shipment
object
required
General shipment metadata mapping to the physical goods in transit.
​
commercialReference
string
required
Commercial reference identifier (e.g., commercial invoice number).
​
procedureType
string
required
The standard customs procedure code (shortcode). Commonly used values:
  • H1 — Release for free circulation
  • H2 — Storage in customs warehousing
  • H3 — Temporary admission
  • H4 — Inward processing
  • H7 — Release for free circulation (DECO / low-value goods under €150)
  • Other codes: I1, I2, B1–B4, C1, C2, D1–D4.
​
declarationType
string
required
The type identifier for the declaration (shortcode). Allowed values:
  • declarationNonEUGoods (shortcode IM) — Standard import declaration from non-EU countries
  • declarationEUGoods (shortcode CO) — Import declaration for EU goods
  • declarationExport (shortcode EX) — Export declaration
​
additionalDeclarationType
string
required
The type code representing the timing and simplification level of the filing (shortcode). Allowed values:
  • STANDARD (code A) — Standard declaration
  • ADVANCE_STANDARD (code D) — Pre-lodged standard declaration
  • SIMPLIFIED_OCCASIONAL (code B) — Simplified occasional declaration
  • ADVANCE_SIMPLIFIED_OCCASIONAL (code E) — Pre-lodged simplified occasional declaration
  • SIMPLIFIED_REGULAR (code C) — Simplified regular declaration
  • ADVANCE_SIMPLIFIED_REGULAR (code F) — Pre-lodged simplified regular declaration
  • SUPPLEMENTARY_PERIODIC_REGULAR (code Y) — Supplementary periodic declaration
  • SUPPLEMENTARY_EIDR (code Z) — Entry in declarant’s records supplementary declaration
​
representation
string
required
The customs representation mode (shortcode). Allowed values:
  • DirectRepresentation — The customs broker acts in the name of and on behalf of the importer (broker EORI required)
  • IndirectRepresentation — The customs broker acts in their own name but on behalf of the importer
  • NoRepresentation — The importer files directly
​
declarationOffice
string
required
The 8-digit customs office identifier where the declaration is submitted (e.g. NL000432).
​
goodsLocationType
string
required
The type code identifying the location category of the goods. Common shortcodes:
  • D — Designated place
  • A — Recognized place
  • B — Approved place
  • C — Competent customs office
​
goodsLocationAddressType
string
required
The code identifying how the address is specified. Common shortcodes:
  • T — Postal address (Address)
  • U — UN/LOCODE
  • V — Customs office ID
  • W — GPS/GNSS coordinates
  • X — EORI number
  • Y — License/Authorization number
​
goodsLocationAddress
object
required
Physical location coordinates or postal address where goods are situated.
​
countryOfDestination
string
required
ISO 2-digit country code of final destination of the transit goods (e.g. NL).
​
arrivalTransportType
string
Border crossing transport mode shortcode. Allowed values:
  • 1 — Maritime transport (Sea)
  • 4 — Air transport
  • 3 — Road transport
  • 2 — Rail transport
  • 8 — Inland waterway transport
​
arrivalTransportNameType
string
The code specifying the type of vehicle identifier. Common values:
  • 40 — Flight number
  • 10 — IMO ship identification number
  • 30 — Road vehicle registration number
​
arrivalTransportName
string
The actual name or number identifying the vessel, flight, or vehicle (e.g., KL0888).
​
borderTransportType
string
Active transport mode crossing the customs border (uses the same transport mode shortcodes as arrivalTransportType).
​
invoiceCurrency
string
required
3-letter ISO code for the commercial invoice currency (e.g. EUR).
​
incoterm
string
required
The Incoterm delivery code (shortcode). Allowed values: EXW, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAP, DPU, DDP, XXX.
​
incotermLocation
string
The designated location associated with the Incoterm terms (e.g., Hoofddorp).
​
Consignee
object
required
The business entity importing the goods.
​
Consignor
object
The business entity exporting the goods.
​
SupportingDocuments
array
Header-level attachments or referenced certificates.
​
AdditionalInformations
array
Header-level statements or declarations.
​
DeclarationItems
array
required
List of items (goods) in the shipment.
JSON Payload
{
  "Shipment": {
    "shipmentNo": "180-43189999",
    "shipmentType": "IMPORT",
    "remarks": "Created via external API full payload"
  },
  "commercialReference": "INV-2026-07001",
  "procedureType": "H1",
  "declarationType": "declarationNonEUGoods",
  "additionalDeclarationType": "STANDARD",
  "representation": "DirectRepresentation",
  "declarationOffice": "NL000432",
  "goodsLocationType": "D",
  "goodsLocationAddressType": "T",
  "goodsLocationAddress": {
    "Address": {
      "houseNo": "25",
      "street": "Mainstraat",
      "city": "Hoofddorp",
      "countryCode": "NL",
      "postCode": "2132NG"
    }
  },
  "countryOfDestination": "NL",
  "arrivalTransportType": "4",
  "arrivalTransportNameType": "40",
  "arrivalTransportName": "KL0888",
  "borderTransportType": "4",
  "invoiceCurrency": "EUR",
  "incoterm": "DDP",
  "incotermLocation": "Hoofddorp",
  "Consignee": {
    "name": "EZC B.V.",
    "street": "Hoofdweg 85",
    "city": "Hoofddorp",
    "postcode": "2133LV",
    "countryCode": "NL",
    "eoriNo": "NL100006139B01"
  },
  "Consignor": {
    "name": "Shanghai Textile Co. Ltd",
    "city": "Shanghai",
    "countryCode": "CN"
  },
  "SupportingDocuments": [
    {
      "typeCode": "N935",
      "description": "INV-2026-07001"
    }
  ],
  "AdditionalInformations": [
    {
      "typeCode": "30600",
      "description": "Low value goods"
    }
  ],
  "DeclarationItems": [
    {
      "description": "Men's cotton trousers",
      "commodityCode": "6203421100",
      "quantity": 500,
      "grossMass": 250,
      "netWeight": 220,
      "netPrice": 1875,
      "currency": "EUR",
      "originCountry": "CN",
      "supplementaryQuantity": 500,
      "supplementaryQuantityUnit": "NAR",
      "additionalProcedureCodes": "F48",
      "SupportingDocuments": [
        {
          "typeCode": "N935",
          "description": "INV-2026-07001"
        }
      ]
    }
  ]
}

{
  "declarationId": 42,
  "shipmentId": 15,
  "referenceNumber": "INV-2026-07001",
  "status": "processing",
  "lrn": "NL202600001"
}