---
title: "Détail d'une facture récurrente (lignes)"
method: GET
path: "/recurring-invoices/{id}"
tags: ["RecurringInvoices"]
---

# Détail d'une facture récurrente (lignes)

`GET /recurring-invoices/{id}`

## Request

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

Scope requis : `invoices:read`.

## Path parameters

- `id` integer, required

## Response `200`

Facture récurrente (détail)

- RecurringInvoiceDetail: Récurrence de facturation, forme de liste. `pendingInvoiceId` = brouillon « prochaine échéance », déjà présent dans la liste des factures (GET /invoices/{id}) ; il est émis à l'échéance (autoSend) ou validé à la main dans l'application.
  - `id` integer
  - `title` string: Libellé de gestion, jamais imprimé sur la facture
  - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'yearly'
  - `anchorDay` integer, nullable: Jour du mois d'ancrage (1 à 31), borné à la fin du mois réel
  - `status` 'active' | 'paused' | 'finished'
  - `autoSend` boolean: true : chaque échéance est émise et envoyée au client sans intervention
  - `nextRunAt` string, date-time: Prochaine échéance
  - `endDate` string, date-time, nullable
  - `maxOccurrences` integer, nullable
  - `occurrencesCount` integer: Échéances déjà émises
  - `object` string, nullable: Objet de chaque facture (les repères de période y sont remplacés à l'émission)
  - `totalHT` union: Montants de chaque échéance
    - number
    - string
  - `totalVAT` union
    - number
    - string
  - `totalTTC` union
    - number
    - string
  - `customer` DocumentParty, nullable: Client (destinataire), forme allégée.
    - `id` integer
    - `name` string, nullable
  - `pendingInvoiceId` integer, nullable
  - `createdFromInvoiceId` integer, nullable: Facture d'origine dont le contenu a été copié
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `lines` DocumentLine[]
    - `description` string
    - `quantity` number, nullable
    - `unit` string, nullable
    - `unitPrice` number, nullable
    - `vatRate` number
    - `discountPercent` number, nullable
    - `catalogItemId` integer, nullable

## Other responses

- `401`: Échec d'authentification : clé API manquante (`missing_api_key`) ou invalide/révoquée/expirée (`invalid_api_key`). Le client doit présenter une clé valide.
- `403`: Clé authentifiée mais non autorisée : scope insuffisant pour cette route (`scope_required`), ou organisation sans abonnement Pro actif (`pro_required`). `GET /me` reste accessible sans Pro pour diagnostiquer la clé.
- `404`: Ressource introuvable

---

[API](https://skmtc.dev/swipify/apis/swipify-api-publique.md) · [All operations](https://skmtc.dev/swipify/apis/swipify-api-publique/llms.txt) · [OpenAPI document](https://skmtc.dev/swipify/apis/swipify-api-publique/revisions/44c17201b479?raw)