# Lister les litiges

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

Demande une clé secrète qui porte le geste « Litiges · lire ».

Les litiges de votre espace, du plus récent au plus ancien.

Le dossier se dépose dans votre espace, pièces à l’appui : l’API le lit, elle ne le remplit pas.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `status` | « needs_response » · « evidence_submitted » · « under_review » · « won » · « lost » | — | Ne rendre que les litiges dans cet état. |
| `payment` | texte | — | Le litige d’un paiement. |
| `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 `dispute`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets dispute | — | Les litiges 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/disputes \
  -H "Authorization: Bearer sk_test_…"
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/disputes",
  "has_more": false,
  "data": [
    {
      "object": "dispute",
      "id": "dp_01j9xh2qr5n8vwd3ke7m",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "needs_response",
      "reason": "Article non reçu",
      "evidence_due_by": 1790614692,
      "evidence_submitted_at": null,
      "closed_at": null,
      "created": 1790009892,
      "livemode": false
    }
  ]
}
```