List Returns

Mirrors the admin Sales → Returns datagrid. Each row carries the return's status and order/customer context; the detail-only fields (item, images, availableStatuses, information, packageCondition, canReopen, messagesCount) are null on the listing — fetch them with Get Return.

The response is wrapped in the { data, meta } envelope.

Endpoint

Endpoint	Method
/api/admin/rma/requests	GET

Query Parameters

Parameter	Type	Description
page, per_page	integer	Pagination (default per_page=10, cap 50).
id	string	Filter by return id (int or comma-list).
order_id	integer	Exact order id.
status	string	Status title (e.g. Pending, Accept, Declined).
customer_name	string	Partial customer name.
created_at_from / _to	date	Created range.
sort	string	id (default), order_id, created_at.
order	string	asc, desc (default desc).

Permission

sales.rma.requests

TIP

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

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