# Retrieve a refund

> Returns a refund of your store.

Source: https://rais.app/docs/api/retrieve-refund

`GET /v1/refunds/{refund_id}`

Required scope: `payments:read`.

A refund of another store, or of the other environment, answers 404.

## Request

### Path parameters

- `refund_id` (string, required): The id of the refund.

### Example request

```bash
curl https://api.rais.app/v1/refunds/0c8a1d52-6e7b-4f0a-9b3d-7d2e4a8c5f10 \
  -H "Authorization: Bearer rais_sk_test_..."
```

## Response

### 200: The refund.

Returns the [Refund object](https://rais.app/docs/api/objects/refund.md).

```json
{
  "id": "0c8a1d52-6e7b-4f0a-9b3d-7d2e4a8c5f10",
  "object": "refund",
  "payment_id": "5b1c2f4e-9d3a-4c61-8a7e-0f2d6b9e1a33",
  "amount": 150000,
  "currency": "DZD",
  "status": "succeeded",
  "reason": "Customer returned one item",
  "failure": null,
  "fees": {
    "satim": 800,
    "rais": 200,
    "total": 1000
  },
  "livemode": false,
  "created": 1793000900
}
```

## Errors

| Status | Code | Example message |
| --- | --- | --- |
| 401 | `invalid_api_key` | Invalid API key provided. |
| 403 | `insufficient_scope` | This API key does not have the 'payments:write' permission. |
| 403 | `account_disabled` | This store is suspended or disabled. |
| 403 | `live_mode_not_enabled` | Complete business verification to take live payments. |
| 404 | `refund_not_found` | No such refund. |
| 429 | `rate_limit_exceeded` | Too many requests. Slow down and retry after the delay in the Retry-After header. |
| 500 | `internal_error` | Something went wrong on our side. Quote the request id to support. |

See [Errors](https://rais.app/docs/errors.md) for every code and how to react.

## Related guides

- [Refunds](https://rais.app/docs/refunds.md)