# Lister les exports

`GET https://api.payiz.app/v1/exports`

Demande une clé secrète qui porte le geste « Rapports · exporter ».

Les exports demandés par l’API, du plus récent au plus ancien, tant que leur fichier se garde.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `limit` | entier | — | De 1 à 100. Par défaut 20. |
| `starting_after` | texte | — | L’identifiant de la dernière ligne lue : la page suivante commence après. |

## Ce qu'on reçoit

`200` · une liste d’objets `export`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets export | — | Les exports de la page, du plus récent au plus ancien. |
| `has_more` | vrai ou faux | — | Vrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue. |
| `url` | texte | — | L’adresse qui a servi, sans les filtres. |

## La demande

```bash
curl https://api.payiz.app/v1/exports \
  -H "Authorization: Bearer sk_test_…"
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/exports",
  "has_more": true,
  "data": [
    {
      "id": "exp_01j9zk4m2q8w5tz7m3kd6hw2pv",
      "object": "export",
      "dataset": "payments",
      "format": "xlsx",
      "columns": [
        "date",
        "reference",
        "description",
        "status",
        "amount",
        "fee",
        "net",
        "currency"
      ],
      "from": "2026-09-01",
      "to": "2026-09-30",
      "currency": "XOF",
      "status": "ready",
      "rows": 92,
      "file_url": "https://api.payiz.app/v1/exports/exp_01j9zk4m2q8w5tz7m3kd6hw2pv/file",
      "expires_at": 1793433600,
      "created": 1790841600,
      "livemode": false
    },
    {
      "id": "exp_01j9zh2c7v5n3qk8w4tm6bd1ra",
      "object": "export",
      "dataset": "ledger",
      "format": "csv",
      "columns": [
        "date",
        "type",
        "reference",
        "credit",
        "debit",
        "balance_after"
      ],
      "from": "2026-09-01",
      "to": "2026-09-30",
      "currency": "XOF",
      "status": "ready",
      "rows": 214,
      "file_url": "https://api.payiz.app/v1/exports/exp_01j9zh2c7v5n3qk8w4tm6bd1ra/file",
      "expires_at": 1793433600,
      "created": 1790755200,
      "livemode": false
    }
  ]
}
```