Skip to main content

List Etsy Refunds

GET 

/api/etsy/instances/:integrationInstance/refunds

Lists the refunds on this shop's Etsy orders, newest first — one row per refund. Etsy has no refund API: refunds are issued in Etsy Shop Manager and arrive with the next order sync. They are shown for reference; the linked SKU.io sales order is not changed.

Required scope: integrations:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Pagination: page, per_page (default 10, max 200).

Search: filter[search] matches the ID (exact for a numeric term), Etsy receipt ID, buyer name and reason.

Sorts: id, amount, status, refunded_at. Default: -refunded_at.

Request​

Responses​

OK

Response Headers
    Content-Type