List Refunds

Mirrors the admin Sales → Refunds datagrid. Every refund column plus the billing/shipping addresses are populated per row — only the line items (and payment info) are detail-only. Field reference is identical to Get Refund.

Endpoint

Endpoint	Method
/api/admin/refunds	GET

Query Parameters

Parameter	Type	Description
page, per_page	integer	Pagination (default per_page=10, cap 50).
id	string	Filter by refund id (int or comma-list).
order_id	string	Partial match on orders.increment_id.
state	string	Refund state.
base_grand_total_from / _to	number	Refund amount range.
billed_to	string	Partial billing-address full-name match.
created_at_from / _to	date	Created range.
sort	string	id, order_id, state, base_grand_total, billed_to, created_at.
order	string	asc, desc.

Permission

sales.refunds.view

INFO

Refund detail, create, and preview live under Orders.