> ## 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 Historique des paiements

> Liste paginée des paiements du compte.

## Endpoint

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

## Paramètres query

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

## Réponse succès `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
  }
}
```

## Règles workspace

Cet endpoint retourne l'**historique de paiements personnel** du propriétaire de la clé. Il exige une **clé API personnelle** (`msgf_live_…`). Une **clé d'équipe** est rejetée en `403` avec le code [`TEAM_KEY_NOT_ALLOWED`](/fr/resources/error-codes#équipes-workspaces). L'historique d'équipe n'est disponible qu'au propriétaire de l'équipe depuis la console via `GET /api/billing/payments` avec `X-Team-Id`.