List freight orders (orders shipping via LTL/freight)
Returns orders where delivery_option = 'freight' OR ships_freight = true,
with a flattened summary of the currently-accepted freight quote (carrier,
service, amount, currency, transit days, accepted_at) joined via a LATERAL
subquery. Cursor pagination is stable on (created_at DESC, id DESC) and the
opaque cursor is a base64-encoded { created_at, id }. Filters are AND-combined.
Layer 1 entity isolation is enforced server-side from the API key; never trust
a body-supplied entity_id. Requires the orders: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 by orders.status (draft / confirmed / fulfilled / invoiced / cancelled / archived).
Filter by orders.location_id (Layer 4).
Inclusive lower bound on created_at.
Exclusive upper bound (created_at < to_date + 1 day).
Filter by resolved NMFC freight class (50, 55, 60, ..., 500).
Substring match (case-insensitive) on the accepted quote's carrier_name.
1 <= x <= 200Opaque cursor from previous page (next_cursor).

