Documentation/Lister les factures
openapi.jsonOuvrir mon espace

Lister les factures

GET/v1/invoices

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

Ce qu’on met dans l’adresse

customertexteLes 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.
searchtexteUn numéro, ou le nom d’un client.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

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
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets invoice

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets invoiceLes factures de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.

© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.
DocumentationMon espace

Lister les factures

GET/v1/invoices

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

Ce qu’on met dans l’adresse

customertexteLes 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.
searchtexteUn numéro, ou le nom d’un client.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

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
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets invoice

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets invoiceLes factures de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.