Invoices

Lister les factures

Factures émises par l'organisation de la clé. Scope requis : invoices:read.

get/invoices

Request

  • Base URL: https://api.swipify.fr/api/v1
  • URL: https://api.swipify.fr/api/v1/invoices
  • Auth: API key in header X-API-Key

Query parameters

pageinteger
pageSizeinteger
status'draft' | 'validated' | 'sent' | 'paid'

Filtre sur le statut (draft, sent, paid…)

overdueboolean

true → uniquement les impayés en retard (à relancer). Une facture due aujourd'hui n'est PAS en retard : l'échéance vaut pour toute sa journée, le retard commence le lendemain (jour calendaire, fuseau Europe/Paris)

einvoiceStatus'pending' | 'delivered' | 'accepted' | 'rejected' | 'paid' | 'reported' | 'error'

Filtre par statut de cycle de vie e-invoice

qstring

Recherche : préfixe sur le numéro OU nom du destinataire

sortOrder'asc' | 'desc'

Response

Page de factures

Example response

{
  "data": [
    {
      "id": 1234,
      "number": "FAC-2026-0042",
      "status": "paid",
      "totalHT": "850.00",
      "totalVAT": "170.00",
      "totalTTC": "1020.00",
      "brandProfileKey": "boutique-lyon",
      "reminderCount": 1
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalCount": 42,
    "totalPages": 3,
    "hasMore": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.