Invoices

Récupérer une facture

Facture unique, scopée à l'organisation de la clé. Scope requis : invoices:read.

get/invoices/{id}

Request

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

Path parameters

idinteger required

Response

Facture

idinteger
numberstring nullable
draftNumberstring nullable
statusstring
objectstring nullable
datestring date-time nullable
dueDatestring date-time nullable
paidDatestring date-time nullable
totalHTstring
totalVATstring
totalTTCstring
einvoiceStatus'pending' | 'delivered' | 'accepted' | 'rejected' | 'paid' | 'reported' | 'error' | 'null' nullable

Statut de cycle de vie e-invoice (PA). null si pas de cycle (brouillon/non conforme). rejected = refusée par la plateforme. reported = vente à un particulier, transmise en e-reporting : pas d'e-facture, donc ni remise ni acceptation client.

brandProfileKeystring nullable

Profil de marque du document. null = profil par défaut.

reminderCountinteger

Nombre de relances d'impayé envoyées (manuelles et automatiques). L'envoi d'une relance reste un geste dans l'application, jamais un appel API.

reminderLastSentAtstring date-time nullable

Date de la dernière relance d'impayé, null si jamais relancée.

remindersPausedboolean

true si les relances automatiques sont suspendues pour cette facture.

recurringboolean

true si la facture a été générée par une facture récurrente.

createdAtstring date-time

Example response

{
  "id": 1234,
  "number": "FAC-2026-0042",
  "status": "paid",
  "totalHT": "850.00",
  "totalVAT": "170.00",
  "totalTTC": "1020.00",
  "brandProfileKey": "boutique-lyon",
  "reminderCount": 1
}

Changes

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