Admin Sales: Refunds
List refunds (datagrid parity)
Paginated refunds listing. Every refund column + billing/shipping addresses are populated per row (line items are detail-only). Returns a { data, meta } envelope. Requires sales.refunds.view.
get/refunds
Request
- Base URLhttp://localhost:8000/api/admin
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
pageinteger
Page number.
per_pageinteger
Items per page (default 10, max 50).
idstring
Filter by refund id (integer or comma-list).
order_idstring
Partial order increment_id match.
statestring
Refund state.
base_grand_total_fromnumber
Min refunded amount.
base_grand_total_tonumber
Max refunded amount.
billed_tostring
Partial billed-to name match.
created_at_fromstring date
Created after.
created_at_tostring date
Created before.
sort'id' | 'order_id' | 'state' | 'base_grand_total' | 'billed_to' | 'created_at'
Sort column.
order'asc' | 'desc'
Sort direction.
Response
AdminRefund collection
Changes
No recorded changes to this operation across all 8 revisions of this API.