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

> GET /api/checkouts/:id — fetch a single checkout's current status.

Fetches one checkout. Use this for reconciliation — e.g. confirming the state of an order whose [callback](/guides/callbacks) never arrived.

<Note>
  Rate limited to **5 requests per minute**. Use callbacks as your primary signal and this endpoint for targeted checks, not bulk polling.
</Note>

## Request

<ParamField path="id" type="string (uuid)" required>
  The checkout ID returned by [create checkout](/api-reference/create-checkout).
</ParamField>

```bash theme={null}
curl https://uat-secure.choosefloat.com/api/checkouts/9b2f61c4-6c1e-4b7a-9a1d-3f2a8c0de111 \
  -H "Authorization: Bearer $FLOAT_CLIENT_SECRET"
```

## Response

```json 200 theme={null}
{
  "data": {
    "id": "9b2f61c4-6c1e-4b7a-9a1d-3f2a8c0de111",
    "type": "checkouts",
    "attributes": {
      "amount": 249900,
      "currency": "GBP",
      "status": "successful",
      "created_at": "2026-07-17T10:30:00Z"
    }
  }
}
```

<ResponseField name="data.attributes.status" type="string">
  One of:

  | Value             | Meaning                                |
  | ----------------- | -------------------------------------- |
  | `received`        | Awaiting shopper action — not paid yet |
  | `successful`      | Paid — safe to fulfil                  |
  | `cancelled`       | Cancelled by the shopper               |
  | `invalid_payload` | The checkout request was invalid       |

  See [How Float works](/concepts/how-float-works#checkout-statuses).
</ResponseField>

<ResponseField name="data.attributes.amount" type="integer">
  Checkout amount in pence.
</ResponseField>

<ResponseField name="data.attributes.created_at" type="string (ISO 8601)">
  When the checkout was created.
</ResponseField>

## Errors

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