CAcargoai

Create Shipment

Changed on

Creates the shipment record for an AWB and returns 201 Created with the full record. The response includes a new shipmentId and version 1.

post/shipments

Request

  • Base URL
    https://api.cargoai.co/solutions
  • URL
    https://api.cargoai.co/solutions/shipments
  • Auth
    API key in header x-api-key

Headers

x-api-keystring required

Your CargoCONNECT API key.

Request body

hawbNumberstring

House air waybill number issued by the forwarder. Required if no Master AWB Number provided in the request.

mawbNumberstring

Master air waybill (AWB) number issued by the airline, format XXX-NNNNNNNN. Used to match booking callbacks. Required if no House AWB Number provided in the request.

status'DRAFT' | 'BOOKED' | 'IN_TRANSIT' | 'AT_DESTINATION' | 'DELIVERED' | 'CANCELLED' | 'EXCEPTION' required

Overall status of the shipment.

Response

Created. The full stored shipment.

shipmentIdstring required

Unique ID of the record, used in PATCH calls. UUID set by the server.

versioninteger required

Revision number of the record. 1 on create, +1 on each PATCH.

hawbNumberstring

House air waybill number issued by the forwarder. Required if no Master AWB Number provided in the request.

mawbNumberstring

Master air waybill (AWB) number issued by the airline, format XXX-NNNNNNNN. Used to match booking callbacks. Required if no House AWB Number provided in the request.

status'DRAFT' | 'BOOKED' | 'IN_TRANSIT' | 'AT_DESTINATION' | 'DELIVERED' | 'CANCELLED' | 'EXCEPTION' required

Overall status of the shipment.

createdAtstring required

When the record was created. RFC 3339, UTC. Set by the server.

lastUpdatedAtstring required

When the record was last changed. RFC 3339, UTC. Set by the server.

Changes