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

# List checkouts

> GET /api/checkouts — paginated list of your checkouts.

Returns your merchant's checkouts, newest first, paginated.

<Note>
  Rate limited to **1 request per minute** — intended for back-office reconciliation. To track a specific payment, use [get a checkout](/api-reference/get-checkout) (5/minute) instead.
</Note>

## Request

<ParamField query="page[number]" type="integer" default="1">
  Page to fetch.
</ParamField>

<ParamField query="page[items]" type="integer" default="10">
  Items per page.
</ParamField>

```bash theme={null}
curl "https://uat-secure.choosefloat.com/api/checkouts?page[number]=1&page[items]=25" \
  -H "Authorization: Bearer $FLOAT_CLIENT_SECRET" -g
```

## 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"
      }
    },
    {
      "id": "1f0c2a7e-8888-4c4c-9999-bb22cc33dd44",
      "type": "checkouts",
      "attributes": {
        "amount": 129900,
        "currency": "GBP",
        "status": "cancelled",
        "created_at": "2026-07-16T14:05:00Z"
      }
    }
  ],
  "links": {
    "first": "https://uat-secure.choosefloat.com/api/checkouts?page[number]=1&page[items]=25",
    "last": "https://uat-secure.choosefloat.com/api/checkouts?page[number]=4&page[items]=25",
    "prev": null,
    "next": "https://uat-secure.choosefloat.com/api/checkouts?page[number]=2&page[items]=25"
  }
}
```

Attributes per item match [Get a checkout](/api-reference/get-checkout). Follow `links.next` until it's `null`.

## Errors

| HTTP  | When                |
| ----- | ------------------- |
| `401` | Bad Bearer token    |
| `429` | Rate limit exceeded |
