> ## 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 chargebacks

> Retrieve chargebacks raised against your orders

Returns chargebacks — refunds forced by the customer's bank rather than issued by you. Unlike a
[refund](/api-reference/refunds/create-refund), a chargeback is initiated by the cardholder
disputing the transaction, and usually carries a fee.

## Endpoint

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

## Authentication

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

```
api-key: YOUR_SECRET_KEY
```

## Request example

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

## Response

Returns the standard envelope with a `data` array of chargeback 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. Confirm the record
  shape against your sandbox account before depending on individual fields.
</Note>

## Refunds and chargebacks

|               | [Refund](/api-reference/refunds/create-refund) | Chargeback                                    |
| ------------- | ---------------------------------------------- | --------------------------------------------- |
| Initiated by  | You                                            | The cardholder's bank                         |
| Triggered via | The API                                        | A dispute the customer raises with their bank |
| Fee           | None                                           | Usually charged to you                        |
| Reversible    | No                                             | Only by winning the dispute                   |

<Warning>
  There is no webhook for chargebacks. Poll this endpoint on a schedule — a dispute you don't
  notice is a dispute you can't respond to before the deadline.
</Warning>

<Tip>
  Most chargebacks are avoidable. Show a recognisable name on the customer's statement, refund
  promptly when a customer asks, and keep [tracked events](/api-reference/orders/track-event)
  and order records so you have evidence if you do have to contest one.
</Tip>

## Common errors

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