Skip to main content
POST
Submit an export declaration
Creates and queues a new export customs declaration. You can send either (1) a simplified external EXPORT payload using type, or (2) the full internal declaration payload. Use the full payload when you need complete field coverage (all parties, all document groups, deliveries, and declaration items). The owning company is always resolved from your API key — any companyId (or Shipment.companyId) provided in the request body is ignored. Validation runs asynchronously — status will move from processing → ready once complete.

​
Request Payload

​
string
Required for the simplified external payload. Must be set to EXPORT. (Omit if sending the full internal payload).
​
object
required
General shipment metadata mapping to the physical goods in transit.
​
string
required
Commercial reference identifier (e.g., commercial invoice number).
​
string
required
The standard customs procedure code (shortcode). Commonly used values:
  • B1 — Standard export declaration
  • B2 — Periodic export declaration
  • B3 — Occasional export declaration
  • B4 — Supplementary export declaration
  • C1 — Simplified declaration
  • C2 — Pre-lodged simplified declaration
  • Other codes: H1–H7, I1, I2, D1–D4.
​
string
required
The type identifier for the declaration (shortcode). Allowed values:
  • declarationExport (shortcode EX) — Export declaration
  • declarationNonEUGoods (shortcode IM) — Standard import declaration from non-EU countries
  • declarationEUGoods (shortcode CO) — Import declaration for EU goods
​
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
​
string
required
The customs representation mode (shortcode). Allowed values:
  • DirectRepresentation — The customs broker acts in the name of and on behalf of the exporter (broker EORI required)
  • IndirectRepresentation — The customs broker acts in their own name but on behalf of the exporter
  • NoRepresentation — The exporter files directly
​
string
required
The 8-digit customs office identifier where the declaration is submitted (e.g. NL000432).
​
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
​
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
​
object
required
Physical location coordinates or postal address where goods are situated.
​
string
required
ISO 2-digit country code of final destination of the export goods (e.g. US).
​
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
​
string
The code specifying the type of vehicle identifier. Common values:
  • 10 — IMO ship identification number
  • 40 — Flight number
  • 30 — Road vehicle registration number
​
string
The actual name or number identifying the vessel, flight, or vehicle (e.g., EVER GIVEN).
​
string
Active transport mode crossing the customs border (uses the same transport mode shortcodes as arrivalTransportType).
​
string
required
3-letter ISO code for the commercial invoice currency (e.g. EUR).
​
string
required
The Incoterm delivery code (shortcode). Allowed values: EXW, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAP, DPU, DDP, XXX.
​
string
The designated location associated with the Incoterm terms (e.g., New York).
​
object
required
The business entity exporting the goods.
​
object
required
The business entity importing the goods.
​
array
Header-level attachments or referenced certificates.
​
array
Header-level statements or declarations.
​
array
required
List of items (goods) in the shipment.