Skip to content

List Shipments (Datagrid)

Mirrors the admin Sales → Shipments datagrid. Every shipment column plus the order/customer context and both the billing and shipping addresses are populated on each row — the field set is identical to Shipment Detail except for the shipped line items, which are returned only by the detail endpoint ([] on the listing).

How this menu works

For when a shipment row appears and what each field means, see the Shipments overview.

Endpoint

EndpointMethod
/api/admin/shipmentsGET

Query Parameters

ParameterTypeDescription
page, per_pageintegerPagination (default per_page=10, cap 50).
idstringFilter by shipment id (int or comma-list).
order_idstringPartial match on orders.increment_id.
total_qtyintegerExact total quantity.
inventory_source_namestringPartial source name.
shipped_tostringPartial shipped-to (address full-name).
order_date_from / order_date_todateOrder created range.
created_at_from / created_at_todateShipment created range.
sortstringid, order_id, total_qty, inventory_source_name, shipped_to, order_date, created_at.
orderstringasc, desc.

Permission

sales.shipments.view

Released under the MIT License.