# Lister les factures

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

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

Vos factures, de la plus récente à la plus ancienne.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `customer` | texte | — | Les factures de ce client. |
| `status` | « draft » · « open » · « paid » · « canceled » | — | Ne rendre que celles dans cet état. |
| `overdue` | « true » | — | Celles dont l’échéance est passée, et que rien n’a payées. |
| `search` | texte | — | Un numéro, ou le nom d’un client. |
| `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 `invoice`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets invoice | — | Les factures 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 -G https://api.payiz.app/v1/invoices \
  -H "Authorization: Bearer sk_test_…" \
  -d customer=cli_01j9xn4rt6m8wqv2hc5d \
  -d limit=2
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/invoices",
  "has_more": true,
  "data": [
    {
      "object": "invoice",
      "id": "fac_01j9xr3nb5p7wtv2kd4q",
      "number": null,
      "customer": "cli_01j9xn4rt6m8wqv2hc5d",
      "customer_name": "Awa Houénou",
      "customer_email": "awa.h@exemple.bj",
      "customer_phone": "+229 01 •• •• 21 07",
      "status": "draft",
      "overdue": false,
      "currency": "XOF",
      "subtotal": 23000,
      "total_discount": 1000,
      "total_tax": 4140,
      "total": 27140,
      "fees_paid_by": "merchant",
      "template": null,
      "note": "Merci de votre confiance.",
      "lines": [
        {
          "object": "invoice_line",
          "id": "lgf_01j9xp8wd3k5tzm7qr2v",
          "description": "Pagne wax 6 yards",
          "detail": "bleu indigo",
          "product": "prd_01j9xm2hp7t4wzq6vc3k",
          "price": "prx_01j9xm3kq8v2tzr5wd7n",
          "quantity": 2,
          "unit_amount": 10000,
          "discount": 0,
          "tax_rate_bps": 1800,
          "amount": 20000,
          "tax": 3600
        },
        {
          "object": "invoice_line",
          "id": "lgf_01j9xp8wd3k5tzm7qr2w",
          "description": "Retouches",
          "detail": "ourlet et cintrage",
          "product": null,
          "price": null,
          "quantity": 1,
          "unit_amount": 4000,
          "discount": 1000,
          "tax_rate_bps": 1800,
          "amount": 3000,
          "tax": 540
        }
      ],
      "payment_link": null,
      "payment_url": null,
      "payment": null,
      "due_date": null,
      "finalized_at": null,
      "sent_at": null,
      "paid_at": null,
      "canceled_at": null,
      "cancellation_reason": null,
      "created": 1790002092,
      "livemode": false
    },
    {
      "object": "invoice",
      "id": "fac_01j9xp6vb2n4rtw8kd3m",
      "number": "FAC-2026-0045",
      "customer": "cli_01j9xn4rt6m8wqv2hc5d",
      "customer_name": "Awa Houénou",
      "customer_email": "awa.h@exemple.bj",
      "customer_phone": "+229 01 •• •• 21 07",
      "status": "open",
      "overdue": false,
      "currency": "XOF",
      "subtotal": 23000,
      "total_discount": 1000,
      "total_tax": 4140,
      "total": 27140,
      "fees_paid_by": "merchant",
      "template": null,
      "note": "Merci de votre confiance.",
      "lines": [
        {
          "object": "invoice_line",
          "id": "lgf_01j9xp8wd3k5tzm7qr2v",
          "description": "Pagne wax 6 yards",
          "detail": "bleu indigo",
          "product": "prd_01j9xm2hp7t4wzq6vc3k",
          "price": "prx_01j9xm3kq8v2tzr5wd7n",
          "quantity": 2,
          "unit_amount": 10000,
          "discount": 0,
          "tax_rate_bps": 1800,
          "amount": 20000,
          "tax": 3600
        },
        {
          "object": "invoice_line",
          "id": "lgf_01j9xp8wd3k5tzm7qr2w",
          "description": "Retouches",
          "detail": "ourlet et cintrage",
          "product": null,
          "price": null,
          "quantity": 1,
          "unit_amount": 4000,
          "discount": 1000,
          "tax_rate_bps": 1800,
          "amount": 3000,
          "tax": 540
        }
      ],
      "payment_link": "lnk_01j9xq2mt7c4vwd8hr5n",
      "payment_url": "https://pay.payiz.app/l/fac-2026-0045-k3f8",
      "payment": null,
      "due_date": 1792594892,
      "finalized_at": 1790002892,
      "sent_at": 1790002893,
      "paid_at": null,
      "canceled_at": null,
      "cancellation_reason": null,
      "created": 1790002092,
      "livemode": false
    }
  ]
}
```