List Returns (GraphQL)

Returns the paginated RMA (return request) queue. Detail-only fields — item, images, availableStatuses, information, packageCondition, canReopen, messagesCount — are null on the listing rows; fetch them with View Return.

The item, images, and availableStatuses fields are JSON values — select them bare (no sub-selection).

Arguments

All arguments are optional and combine in a single query — filter, sort and paginate together.

Pagination

Argument	Description
first	Number of records to return.
after	Cursor to fetch the page after (from pageInfo.endCursor).

Filters

Each filter narrows the result; supplying more than one combines with logical AND.

Argument	Type	Match
id	Int	Exact return id.
order_id	Int	Exact order id.
status	String	Status title (e.g. Pending, Accept, Declined).
customer_name	String	Partial customer name.

Sorting

Argument	Type	Values
sort	String	id (default), order_id, created_at
order	String	asc, desc (default desc)

TIP

See the Returns overview for the status workflow and action semantics.

Permission: sales.rma.requests.

All admin operations require an admin Bearer token — see Authentication.