---
title: "Boîte de réception fournisseurs (factures reçues)"
method: GET
path: "/inbox"
tags: ["Inbox"]
---

# Boîte de réception fournisseurs (factures reçues)

`GET /inbox`

## Request

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

Liste paginée des factures FOURNISSEURS reçues via la plateforme agréée (réforme 2026). Lecture seule. Scope requis : `inbox:read`. Les factures reçues restent listées après un changement administratif de l'organisation (ex. raison sociale) : le rattachement se fait par organisation.

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Page de factures reçues

- PaginatedInbox
  - `data` InboxItem[]
    - `id` integer
    - `receivedAt` string, date-time, nullable
    - `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.
    - `senderName` string, nullable
    - `senderSiren` string, nullable
    - `originalNetwork` string, nullable
    - `originalFormat` string, nullable
    - `paymentReportedAt` string, date-time, nullable
    - `document` object, nullable
      - `id` integer
      - `filename` string, nullable
      - `mimeType` string, nullable
      - `fileSize` integer, nullable
  - `pagination` Pagination
    - `page` integer
    - `pageSize` integer
    - `totalCount` integer
    - `totalPages` integer: Nombre total de pages (ceil(totalCount / pageSize)).
    - `hasMore` boolean: true s'il existe une page suivante (page < totalPages).

## 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é.
- `429`: Trop de requêtes (quota de la clé API, ou de l'organisation pour les analyses de document, dépassé pour la fenêtre courante)

---

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