List vendor returns
Returns a paginated list of vendor return records (outbound RMAs to suppliers) for the entity.
Supports filtering by vendor_account_id, status (draft / shipped / credited / cancelled),
date_range, and location_id (Layer 4 warehouse isolation, inherited via the
customer RMA’s originating order). Results are cursor-paginated using next_cursor.
Requires returns: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. Vendor returns
inherit location from the originating customer RMA's source order
(vendor_returns.rma_id -> returns.original_order_id -> orders.location_id).
Vendor returns whose chain resolves to NULL 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.vendor, data.rma, data.line_items, data.vendor_credits 
