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

# GET Payment history

> Paginated list of account payments.

## Endpoint

```txt theme={null}
GET /api/v1/billing/payments
```

## Parameters query

| Nom     | Type    | Required | Description            |
| ------- | ------- | -------- | ---------------------- |
| `page`  | integer | no       | Défaut `1`             |
| `limit` | integer | no       | Défaut `20`, max `100` |

## Success response `200`

```json theme={null}
{
  "data": {
    "payments": [
      {
        "id": "pay_uuid",
        "provider": "dodo",
        "planCode": "pro",
        "planName": "Pro",
        "amount": 900,
        "currency": "EUR",
        "status": "succeeded",
        "periodStart": "2026-04-01T09:43:13.737Z",
        "periodEnd": "2026-05-01T09:43:13.737Z",
        "createdAt": "2026-04-01T09:43:13.745Z"
      }
    ],
    "total": 1,
    "page": 1,
    "totalPages": 1
  }
}
```

## Workspace rules

This endpoint returns the **personal payment history** of the key owner. It requires a **personal API key** (`msgf_live_…`). A **team API key** is rejected with `403` and code [`TEAM_KEY_NOT_ALLOWED`](/resources/error-codes#teams-workspaces). Team payment history is only available to the team owner from the console under `GET /api/billing/payments` with `X-Team-Id`.