Documentation API

REST API v1

Intégrez la facturation électronique conforme dans votre application. L'API Invoquo vous permet de créer des factures, gérer vos clients et automatiser vos flux comptables via une interface REST simple et documentée.

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête X-Api-Key. Vous pouvez générer votre clé depuis les paramètres de votre compte Invoquo.

curl -X GET https://app.invoquo.fr/api/v1/invoices \
  -H "X-Api-Key: votre_cle_api" \
  -H "Content-Type: application/json"

Endpoints

L'API expose les endpoints suivants. Toutes les réponses suivent le format { success, data, error, timestamp }.

MéthodeEndpointDescription
GET/api/v1/clientsListe des clients
POST/api/v1/clientsCréer un client
GET/api/v1/invoicesListe des factures
POST/api/v1/invoicesCréer une facture
GET/api/v1/invoices/:idDétail d’une facture
GET/api/v1/quotesListe des devis
POST/api/v1/quotesCréer un devis
POST/api/v1/quotes/:id/convertConvertir un devis en facture
GET/api/v1/statsStatistiques (CA, factures, impayés)
POST/api/v1/embed/tokenGénérer un jeton embed (iframe)

Exemple : créer une facture

Voici un exemple complet de création de facture via l'API. La facture est automatiquement générée au format Factur-X et peut être transmise via la Plateforme Agréée.

curl -X POST https://app.invoquo.fr/api/v1/invoices \
  -H "X-Api-Key: votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "cl_abc123",
    "date": "2026-03-29",
    "dueDate": "2026-04-28",
    "paymentTerms": "30_days",
    "operationCategory": "services",
    "lines": [
      {
        "description": "Rénovation salle de bain — main d\u0027œuvre",
        "quantity": 3,
        "unitPriceHT": 450.00,
        "vatRate": 10.00,
        "unit": "jour"
      },
      {
        "description": "Fournitures sanitaires",
        "quantity": 1,
        "unitPriceHT": 820.00,
        "vatRate": 20.00,
        "unit": "lot"
      }
    ]
  }'

Intégration embed

Invoquo peut être intégré en marque blanche dans votre application via trois modes complémentaires.

Recommandé

React SDK

Intégrez les composants de facturation directement dans votre application React. Le SDK gère l'authentification, le theming et la communication avec l'API Invoquo.

iframe

Embarquez Invoquo dans une iframe avec un jeton embed (JWT d'une durée d'une heure). Le theming s'adapte automatiquement aux couleurs de votre application via les variables CSS. La communication parent-iframe utilise postMessage.

API REST headless

Utilisez l'API REST pour récupérer les données (compteurs, badges, notifications) et construire votre propre interface. Idéal pour afficher un résumé de facturation dans le tableau de bord de votre application.

Limites et format

Limite de débit100 requêtes par minute par clé API
Format des réponsesJSON (application/json)
EncodageUTF-8
Pagination?page=1&limit=20 — réponse inclut total, page, totalPages
Codes HTTP200, 201, 400, 401, 403, 404, 422, 429, 500

Prêt à intégrer Invoquo ?

Créez votre compte gratuitement et générez votre clé API en quelques minutes. Besoin d'aide ? Contactez-nous à support@invoquo.fr.