---
title: "Synthèse de facturation (CA, impayés)"
method: GET
path: "/stats"
tags: ["Stats"]
---

# Synthèse de facturation (CA, impayés)

`GET /stats`

## Request

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

Compteurs et montants agrégés de l'organisation de la clé. `period=monthly` ajoute `monthly` (série mensuelle des recettes encaissées de l'année en cours). Scope requis : `stats:read`.

## Query parameters

- `period` 'monthly'

## Response `200`

Synthèse

- Stats
  - `currency` string
  - `invoices` object
    - `draft` integer
    - `validated` integer
    - `sent` integer
    - `paid` integer
    - `total` integer
  - `revenue` object
    - `paid` string
    - `outstanding` string
    - `overdue` string
    - `paidThisYear` string
    - `paidThisMonth` string
  - `monthly` object[]: Présent uniquement si `period=monthly`. Recettes encaissées par mois comptable de l'année en cours (12 entrées).
    - `month` string
    - `paid` string
    - `count` integer

## 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é.

---

[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)