> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2.reeple.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List refunds

> Retrieve the refunds issued against your orders

Returns refunds you have issued with
[Create a refund](/api-reference/refunds/create-refund), so you can reconcile them and track
settlement.

## Endpoint

```
GET https://api-v4.reeple.ai/charge/order/refunds/all
```

## Authentication

Authenticate with your **secret key** in the `api-key` header.

```
api-key: YOUR_SECRET_KEY
```

## Query parameters

| Field | Type   | Description                                                           |
| ----- | ------ | --------------------------------------------------------------------- |
| `Id`  | String | Optional. Return a single refund by its id. Omit to list all refunds. |

<Note>
  The parameter is `Id`, capitalised.
</Note>

## Request example

```bash theme={null}
# all refunds
curl "https://api-v4.reeple.ai/charge/order/refunds/all" \
  -H "api-key: YOUR_SECRET_KEY"

# one refund
curl "https://api-v4.reeple.ai/charge/order/refunds/all?Id=REFUND_ID" \
  -H "api-key: YOUR_SECRET_KEY"
```

## Response

Returns the standard envelope with a `data` array of refund records.

```json theme={null}
{
  "data": [],
  "status": "success",
  "statusCode": "00",
  "message": "Operation successful"
}
```

<Note>
  The provider has not published a populated response body for this endpoint. Issue a refund on
  sandbox and read it back to confirm the record's field names before depending on them.
</Note>

## Common errors

| Code  | Message                                          | Cause                                               |
| ----- | ------------------------------------------------ | --------------------------------------------------- |
| `401` | `Invalid SECRET key. Please check and try again` | Wrong key type, or a key from the other environment |

<Tip>
  Reconcile against this endpoint rather than your own records alone. A refund that failed to
  settle at the bank will show here but never reach the customer.
</Tip>