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

# Get a refund

> GET /api/refunds/:id — track a refund request's status.

Fetches one refund request. Poll this (respecting the rate limit) after [creating a refund](/api-reference/create-refund) to confirm it reaches `complete`.

<Note>
  Rate limited to **5 requests per minute**.
</Note>

## Request

<ParamField path="id" type="string (uuid)" required>
  The refund request ID returned by create refund.
</ParamField>

```bash theme={null}
curl https://uat-secure.choosefloat.com/api/refunds/5d1a7c9e-2222-4444-8888-aa11bb22cc33 \
  -H "Authorization: Bearer $FLOAT_CLIENT_SECRET"
```

## Response

```json 200 theme={null}
{
  "data": {
    "id": "5d1a7c9e-2222-4444-8888-aa11bb22cc33",
    "type": "refund_requests",
    "attributes": {
      "amount": 100000,
      "currency": "GBP",
      "status": "complete",
      "created_at": "2026-07-17T11:00:00Z"
    }
  }
}
```

<ResponseField name="data.attributes.status" type="string">
  | Value       | Meaning                             |
  | ----------- | ----------------------------------- |
  | `requested` | Awaiting review                     |
  | `pending`   | Approved, processing                |
  | `complete`  | Refund processed                    |
  | `failed`    | Processing failed — contact support |
</ResponseField>

## Errors

| HTTP  | When                                                    |
| ----- | ------------------------------------------------------- |
| `401` | Bad Bearer token                                        |
| `404` | No refund request with that ID belongs to your merchant |
| `429` | More than 5 requests per minute                         |