---
title: "List the refunds against an order"
method: GET
path: "/shop/orders/{orderId}/refunds"
tags: ["Orders"]
---

# List the refunds against an order

`GET /shop/orders/{orderId}/refunds`

List every refund that has been recorded against the order,
across every payment. Refunds carry the amount, status, the
payment they were issued against, operator notes, and how the
refund was allocated across basket items / revenue centres.

Optionally filter with `revenue_centre` to return only refunds
that allocate to that centre. The response is not paginated;
most orders have a handful of refunds at most.

To create a new refund, use `POST
/shop/orders/{orderId}/payments/{paymentId}/refunds`.

## Response `200`

The refunds recorded against the order.

- object
  - `data` Refund[], required
    - `id` string, object-id, required — The ID of the refund.
    - `payment_id` string, object-id, required — The ID of the payment that was refunded.
    - `amount` integer, required — The amount of the refund.
    - `currency` string, required — The ISO-4217 currency code.
    - `notes` string, nullable — Notes that were added against the refund.
    - `status` 'pending' | 'complete' | 'failed', required — The current status of the refund.
    - `processor_data` object, required — A dictionary of processor-specific data.
    - `created_at` string, date-time, required — The date and time that the refund was created.

## Other responses

- `401` — The user is unauthenticated
- `403` — The authenticated user does not have permission.
- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)