# List refunds

> List the refunds of a payment, newest first.

`GET https://api.camelpayment.com/v1/payments/{payment_id}/refunds`

Returns every refund of the payment in one response, without a cursor.

## Path parameters

- `payment_id` (string, required): The payment id, starting with pay_.

## Request

**cURL**

```bash
curl https://api.camelpayment.com/v1/payments/pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA/refunds \
  -H "Authorization: Bearer $CAMEL_API_KEY"
```

**Node.js**

```javascript
const response = await fetch('https://api.camelpayment.com/v1/payments/pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA/refunds', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CAMEL_API_KEY}`
  }
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    "https://api.camelpayment.com/v1/payments/pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA/refunds",
    headers={
        "Authorization": f"Bearer {os.environ['CAMEL_API_KEY']}",
    },
)
data = response.json()
```

## Response

**200**

```json
{
  "data": [
    {
      "id": "ref_01JBX8A1B2C3D4E5F6G7H8J9KM",
      "payment_id": "pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA",
      "provider_refund_id": "987654321",
      "amount": 500000,
      "currency": "ARS",
      "status": "approved",
      "provider_status": "approved",
      "failure_code": null,
      "created_at": "2026-11-12T16:10:00Z",
      "updated_at": "2026-11-12T16:10:02Z"
    }
  ]
}
```

## Errors

| Status | When |
| --- | --- |
| `401` | The API key is missing, malformed, or revoked. |
| `404` | No payment with this id in this environment. |
| `429` | Too many requests. Wait for Retry-After seconds. |
