Intégrez FactureKit à vos propres outils.

L'API REST arrive. Elle permettra de créer vos factures et devis, de synchroniser vos clients et de réagir aux événements en temps réel. Elle sera incluse dans l'offre Pro Max.

Commencer gratuitement Demander un accès

Aperçu : facturekit-api

$ curl -X POST https://api.facturekit.fr/v1/invoices \
  -H "Authorization: Bearer fk_live_8c2a…f91" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "cli_4f8b3a",
    "currency": "EUR",
    "due_in_days": 30,
    "lines": [
      { "label": "Prestation de conseil", "qty": 1, "unit_price": 1200.00, "tax_rate": 20 },
      { "label": "Développement (15 h)",  "qty": 15, "unit_price": 60.00,  "tax_rate": 20 }
    ]
  }'

{
  "id": "inv_b71e0c",
  "number": "FA-2026-0042",
  "status": "draft",
  "total_ht": 2100.00,
  "total_tva": 420.00,
  "total_ttc": 2520.00,
  "pdf_url": "https://api.facturekit.fr/v1/invoices/inv_b71e0c/pdf"
}

Tout ce que vous faites dans l'app, bientôt en appel HTTP

Voici la surface REST envisagée : cohérente, en JSON, elle couvrira les mêmes objets que l'application : factures, devis, clients et entreprises.

API REST en JSON

Des routes versionnées sous /v1, des verbes HTTP standards et des réponses JSON prévisibles. Pas de SDK obligatoire : un client HTTP suffit.

Clés API

Le principe prévu : une clé par environnement, créée depuis les réglages de l'entreprise, révocable à tout moment et transmise en en-tête Authorization: Bearer.

Webhooks d'événements

Recevez un POST signé sur votre endpoint à chaque invoice.paid, quote.accepted ou client.created. Inutile d'interroger l'API en boucle.

Factures & devis

Créez, mettez à jour et récupérez factures et devis par programmation, avec TVA multi-taux, numérotation continue et PDF Factur-X généré côté serveur.

Clients

Synchronisez votre base clients depuis un CRM ou un ERP : SIRET, coordonnées et conditions de paiement restent alignés avec FactureKit.

Sandbox

Un environnement de test isolé avec ses propres clés fk_test_. Émettez des factures fictives sans toucher à vos données réelles ni à votre numérotation.

Une facture conforme, créée par appel API

Envoyez vos lignes en euros : l'API applique la TVA multi-taux par ligne, calcule le récapitulatif au centime et attribue le prochain numéro de votre séquence légale.

Réponse immédiate avec totaux HT, TVA et TTC, statut et identifiant stable.
Champ facturx: true pour obtenir un PDF/A-3 hybride avec XML EN 16931 embarqué.
Mentions micro-entreprise gérées automatiquement (TVA non applicable, art. 293 B du CGI).
Récupérez le PDF prêt à l'envoi via le lien renvoyé dans la réponse.

POST /v1/invoices

{
  "client_id": "cli_4f8b3a",
  "currency": "EUR",
  "due_in_days": 30,
  "lines": [
    {
      "label": "Abonnement annuel",
      "qty": 1,
      "unit_price": 490.00,
      "tax_rate": 20
    }
  ],
  "facturx": true
}

Comment se brancher, une fois l'API ouverte

Récupérez une clé

Vous créerez une clé fk_live_ (ou fk_test_ pour la sandbox) depuis les réglages de l'entreprise, à conserver côté serveur, jamais dans le navigateur.

Appelez l'API

Authentifiez chaque requête avec votre clé en en-tête Bearer, puis créez factures, devis et clients via les routes /v1.

Écoutez les webhooks

Déclarez votre endpoint HTTPS et réagissez aux événements (paiement, acceptation de devis) au lieu d'interroger l'API régulièrement.

L'accès API sera inclus dans l'offre Pro Max

À son ouverture, les clés API, les webhooks et l'environnement sandbox feront partie de Pro Max (14,99 €/mois, jusqu'à 10 entreprises), avec le support prioritaire. Les offres Gratuit et Pro donnent dès aujourd'hui accès à toute l'application. Comparer les offres.

Pensée pour des intégrations fiables

Webhooks signés

Chaque livraison porte une signature HMAC dans l'en-tête. Vérifiez-la avant de traiter la charge utile pour rejeter les appels non authentiques.

Idempotence

Passez un en-tête Idempotency-Key sur vos créations : un même identifiant ne crée jamais deux factures, même en cas de nouvelle tentative réseau.

Erreurs lisibles

Codes HTTP standards et corps d'erreur explicite (code, message, champ concerné) pour déboguer sans deviner.

Ce que demandent les développeurs

Les requêtes et réponses seront en JSON (Content-Type: application/json), encodées en UTF-8. Les montants sont exprimés en euros avec deux décimales ; l'API convertit en interne vers le stockage en centimes. Le format Factur-X généré est détaillé sur notre page dédiée à la réforme.