---
title: "List refunds"
method: GET
path: "/refunds"
---

# List refunds

`GET /refunds`

Lists refunds for the authenticated client. Optionally filter by nonce, charge, or terminal session.

## Query parameters

- `nonce` string — A unique identifier for this specific resource. Use the nonce to ensure idempotency. If you attempt to create a resource with a nonce that has already been used, an error will be returned.
- `charge` string
- `terminalSession` string
- `limit` integer
- `offset` integer

## Response `200`

Returns a paginated list of refunds

- object
  - `data` Refund[], required — The list of refunds for this page.
    - `id` string, required — The unique identifier for this refund.
    - `type` 'card' | 'in_person_card' — The type of refund.
    - `charge` string, required — The unique identifier of the charge being refunded.
    - `amount` number, required — The refund amount in the currency's major unit (e.g., 30.0 for R30.00).
    - `currency` 'ZAR', required — The refund currency in ISO 4217 format. Only "ZAR" is currently supported.
    - `reason` 'fraud' | 'requested_by_customer' | 'duplicate_charge', required — The reason for the refund.
    - `status` 'processing' | 'success' | 'paused' | 'failure', required — The current status of the refund. `processing` indicates the refund is being processed, `success` indicates the refund was processed successfully, `paused` indicates the refund is paused pending resolution, and `failure` indicates the refund did not complete successfully.
    - `nonce` string, required — A unique identifier for this specific resource. Use the nonce to ensure idempotency. If you attempt to create a resource with a nonce that has already been used, an error will be returned.
    - `metadata` Metadata — A set of key-value pairs that you can attach to the resource. Use metadata to store additional, structured information relevant to your integration.
    - `createdAt` string, date-time, required — The UTC timestamp indicating when the refund was created. Formatted as an ISO 8601 string (e.g., 2024-01-15T09:30:00Z).
    - `updatedAt` string, date-time, required — The UTC timestamp indicating when the refund was last modified, such as when the status changes. Formatted as an ISO 8601 string (e.g., 2024-01-15T09:35:00Z).
  - `page` object, required — Pagination information for this response.
    - `limit` integer, required — The limit used for this response.
    - `offset` integer, required — The offset used for this response.
    - `hasNext` boolean, required — Whether there is a next page for this response.

---

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