List shipping labels for the entity
Returns a paginated list of shipping labels purchased by the entity. Supports filtering by
package_id, carrier, status (valid / voided / refunded), date_range, and location_id
(Layer 4 warehouse isolation, inherited via the label’s package -> order). Each label
record includes the carrier, service, tracking number, label URL, and cost.
Requires fulfillment:read scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Query Parameters
Filter to a single warehouse location (Layer 4 isolation). Resolved from the
X-Location-Id request header first, then this query param. Labels inherit
location from their package's order
(package_shipment_labels.package_id -> packages.order_id -> orders.location_id);
labels whose origin-order has NULL location_id remain visible at every location
(NULL-universal).
Maximum number of records to return per page. Default 25, max 500. Use together with starting_after for cursor pagination. For larger bulk extraction workflows prefer the migration endpoints.
1 <= x <= 500Cursor for pagination. Pass the id of the last record from the previous page to fetch the next page. Mutually exclusive with ending_before.
200data.package, data.order 
