---
title: "Détail d'un avoir"
method: GET
path: "/credit-notes/{id}"
tags: ["CreditNotes"]
---

# Détail d'un avoir

`GET /credit-notes/{id}`

## Request

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

Scope requis : `creditnotes:read`.

## Path parameters

- `id` integer, required

## Response `200`

Avoir (détail)

- CreditNoteDetail: Avoir, forme de liste (sans client ni lignes).
  - `id` integer
  - `number` string, nullable
  - `draftNumber` string, nullable
  - `status` string
  - `creditType` string, nullable
  - `creditReason` string, nullable
  - `originalInvoiceId` integer, nullable
  - `originalInvoiceNumber` string, nullable
  - `date` string, date-time, nullable
  - `totalHT` string
  - `totalVAT` string
  - `totalTTC` string
  - `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.
  - `createdAt` string, date-time
  - `customer` DocumentParty, nullable: Client (destinataire), forme allégée.
    - `id` integer
    - `name` string, nullable
  - `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)