Skip to main content
POST
/
v1
/
shipments
Create shipment
curl --request POST \
  --url https://sandbox-api.easecustoms.com/v1/shipments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "referenceNumber": "<string>",
  "localReferenceNo": "<string>",
  "remarks": "<string>",
  "totalWeight": 123,
  "totalPrice": 123
}
'
{
  "shipmentId": 99,
  "referenceNumber": "180-43189021",
  "localReferenceNo": "PO-2026-001",
  "remarks": "External API shipment",
  "totalWeight": 480,
  "totalPrice": 9500,
  "status": "draft",
  "createdAt": "2026-06-22T17:00:00.000Z",
  "updatedAt": "2026-06-22T17:00:00.000Z"
}
Create a new shipment that can be used for declarations submitted via external API.

​
Body

​
referenceNumber
string
required
The unique reference number of the shipment (e.g., Master Bill of Lading, Air Waybill).
​
localReferenceNo
string
The local reference number or Purchase Order number.
​
remarks
string
Additional remarks or notes for the shipment.
​
totalWeight
number
The total gross weight of the shipment.
​
totalPrice
number
The total value or price of the shipment.
{
  "shipmentId": 99,
  "referenceNumber": "180-43189021",
  "localReferenceNo": "PO-2026-001",
  "remarks": "External API shipment",
  "totalWeight": 480,
  "totalPrice": 9500,
  "status": "draft",
  "createdAt": "2026-06-22T17:00:00.000Z",
  "updatedAt": "2026-06-22T17:00:00.000Z"
}