List RMAs (return merchandise authorizations)
Returns a paginated list of customer return (RMA) records for the entity. Supports filtering
by account_id, status (open / inspected / closed / cancelled), date_range, full-text
search, and location_id (Layer 4 warehouse isolation). 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
authorized, expected, received, inspecting, restocked, written_off, closed, sent_to_vendor, cancelled Filter to a single warehouse location (Layer 4 isolation). Resolved from the
X-Location-Id request header first, then this query param. Returns whose
originating order has NULL location_id, or returns with no original_order_id,
remain visible (NULL-universal). Returns with no origin-order match are excluded.
items, refunds, original_order, gl_entries, return_label, vendor_return 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.
200
