v1

latestOpenAPI 3.0.32026-07-26170311887.2 KB
Shipments

List all Shipments

Retrieve a list of shipments.

Required authorization scope: public.shipment:read

get/2024-09/shipments

Query parameters

pageinteger

Page number to fetch, default: 1

per_pageinteger

Number of records per page to fetch, default: 20

easyship_shipment_idstring[]

Easyship Shipment ID provided when creating the shipment.

platform_order_numberstring

Order number on the sales platform.

created_at_fromstring

Search for shipments created since this date: ISO8601 date format.

created_at_tostring

Search for shipments created before this date: ISO8601 date format.

updated_at_fromstring

Search for shipments updated since this date: ISO8601 date format.

updated_at_tostring

Search for shipments updated before this date: ISO8601 date format.

label_paid_at_fromstring

Search for shipments where the labels were paid for since this date: ISO8601 date format.

label_paid_at_tostring

Search for shipments where the labels were paid for before this date: ISO8601 date format.

label_generated_at_fromstring

Search for labels generated since this date: ISO8601 date format.

label_generated_at_tostring

Search for labels generated before this date: ISO8601 date format.

shipment_state'created' | 'cancelled'

Search by current status of shipment.

label_statestring[]

Search by current label status of shipment.

pickup_statestring[]

Search by current pickup status of shipment.

delivery_statestring[]

Search by current delivery status of shipment.

warehouse_statestring[]

For eFulfilment only. Search by current warehouse status of shipment.

origin_country_alpha2string[]

Search by the shipment origin country code: Alpha-2 format (ISO 3166-1).

destination_country_alpha2string[]

Search by shipment destination country code: Alpha-2 format (ISO 3166-1).

returnstring

Search by shipment whether the shipment is return shipment or not.

Response

list of shipments