# Lire un export

`GET https://api.payiz.app/v1/exports/{id}`

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

Un export, et où en est son fichier.

## Ce qu'on reçoit

`200` · un objet `export`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `id` | texte | — | Un identifiant préfixé « exp_ », par exemple exp_01j9zk4m2q8w5tz7m3kd6hw2pv. |
| `object` | « export » | — | Le genre de l’objet rendu : il ne change jamais. |
| `dataset` | texte | — | Ce qui est exporté, comme demandé. |
| `format` | « csv » · « xlsx » | — | Le format du fichier. |
| `columns` | liste | — | Les colonnes du fichier, dans l’ordre. |
| `from` | texte | — | Le premier jour couvert. |
| `to` | texte | — | Le dernier jour couvert. |
| `currency` | texte | — | Le code ISO 4217, en majuscules. |
| `status` | « pending » · « ready » · « failed » | — | Où en est le fichier. « failed » : il n’a pas pu se préparer ; demandez-en un autre. |
| `rows` | entier | — | Le nombre de lignes du fichier. |
| `file_url` | texte ou null | — | L’adresse du fichier une fois prêt (GET, avec votre clé secrète). Null tant qu’il se prépare. |
| `expires_at` | entier | — | Des secondes depuis 1970 : le fichier s’efface ensuite. |
| `created` | entier | — | Des secondes depuis 1970. |
| `livemode` | vrai ou faux | — | Faux en mode test : aucun argent ne circule. |

## La demande

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

## La réponse

```json
{
  "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": "pending",
  "rows": 92,
  "file_url": null,
  "expires_at": 1793433600,
  "created": 1790841600,
  "livemode": false
}
```