# Lire un litige

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

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

Un litige, et où il en est.

## Ce qu'on reçoit

`200` · un objet `dispute`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « dispute » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « dp_ », par exemple dp_01j9x3kq7m4tzv8qhw2n. |
| `payment` | texte | — | Le paiement contesté. |
| `amount` | entier | — | La somme contestée, retenue sur votre solde le temps du litige. |
| `currency` | texte | — | Le code ISO 4217, en majuscules. |
| `status` | « needs_response » · « evidence_submitted » · « under_review » · « won » · « lost » | — | « needs_response » : votre dossier est attendu avant « evidence_due_by » ; « under_review » : la banque du payeur tranche. |
| `reason` | texte | — | Le motif donné par le payeur ou sa banque. |
| `evidence_due_by` | entier ou null | — | Le dossier doit partir avant cette date. |
| `evidence_submitted_at` | entier ou null | — | Quand votre dossier est parti. |
| `closed_at` | entier ou null | — | Quand l’issue est tombée. |
| `created` | entier ou null | — | Des secondes depuis 1970, ou null. |
| `livemode` | vrai ou faux | — | Faux en mode test : aucun argent ne circule. |

## La demande

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

## La réponse

```json
{
  "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
}
```