API publique

MaFactureOK n’est pas qu’un vérificateur : c’est une brique que vous insérez dans vos automatisations pour réduire les rejets à la source. Gratuite en bêta : demandez une clé par email, elle arrive aussitôt et reste stable. L’API ne reçoit que des identifiants publics et ne renvoie que des données publiques ; le site, lui, reste utilisable sans clé.

Tutoriel : automatiser avec Make

Obtenir une clé (gratuit, immédiat)

Vérifier des tiers

POST /api/public/v1/verifier-tiers : jusqu’à 25 SIREN (9 chiffres) ou SIRET (14 chiffres) par appel. Pour chacun : existe, actif ou cessé, raison sociale et adresse officielles, numéro de TVA (registre DGFiP, arbitré par VIES sinon), et un signal prêt à router.

curl -X POST https://mafactureok.com/api/public/v1/verifier-tiers \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mfok_live_votre_cle" \
  -d '{ "identifiants": ["456500537", "897865184"] }'

{
  "version": "1.0",
  "verifie_le": "2026-08-24T10:00:00Z",
  "resultats": [
    { "identifiant": "456500537", "existe": true, "etat": "actif",
      "raison_sociale": "DALKIA",
      "adresse": "PANORAMA 204 RUE SADI CARNOT 59350 SAINT-ANDRE-LEZ-LILLE",
      "tva": { "numero": "FR42456500537", "statut": "valide" },
      "signal": "ok", "action": null },
    { "identifiant": "897865184", "existe": true, "etat": "cesse",
      "date_cessation": "2024-12-09", "signal": "alerte",
      "action": "Entreprise cessée : ne pas facturer sous cet identifiant sans vérification humaine." }
  ]
}

Signaux: ok
avertissement (TVA invalide, SIRET périmé, diffusion restreinte)
alerte (entreprise cessée ou introuvable)
indetermine (service officiel momentanément indisponible : le seul cas où relancer a un sens)
Codes: 200
401 (clé absente ou invalide : demandez-en une ci-dessus)
400 (corps ou identifiant invalide)
413 (plus de 25 identifiants)
429 avec Retry-After (quota bêta : 200 identifiants vérifiés par jour et par clé)
503 (vérification indisponible)
Contrat: versionné et figé ; un changement cassant passera par /v2/.
Confidentialité: l’API ne reçoit que des identifiants publics, jamais une facture, un nom de client ou un montant ; votre email n’est conservé que pour la clé et le suivi d’usage, et jamais utilisé pour du marketing sans la case dédiée. Détails.

Le workflow de référence

Vérifier avant de facturer, router selon le signal, ne relancer que ce qui peut changer. La correction est une étape à part, que vous branchez si vous la voulez : nous ne corrigeons jamais en douce.

Source
CRM, Google Sheet, bon de commande : la liste des clients à facturer.
MaFactureOK : vérifier
Un nœud HTTP appelle verifier-tiers ; chaque tiers revient avec un signal.
Routeur
Une branche par signal :
- signal = ok : créer la facture dans votre logiciel
- signal = indetermine : attendre puis relancer (seul cas de retry)
- alerte ou avertissement : corriger ou notifier un humain
Votre suite
Notification, ticket, stockage : le dernier maillon vous appartient. Nous nous arrêtons à « donnée fiable ou anomalie qualifiée ».

Règle d’or du retry : relancez uniquement sur indetermine ou sur un 429 (en respectant Retry-After). Une alerte ou un avertissement décrit le fond : réessayer ne le changera pas.

La suite de la famille /v1/

POST /api/public/v1/valider-facture est ouvert : envoyez le fichier Factur-X, UBL ou CII tel quel (corps binaire, sans clé, quotas du site), vous recevez le rapport digéré en français : verdict, anomalies avec la correction et l’emplacement, état des entreprises de la facture. corriger-facture (XML corrigé quand des corrections sont dérivables) arrivera ensuite. Validation et correction resteront deux actes distincts.

Les mêmes vérifications existent sous forme de serveur MCP pour ChatGPT, Claude et les clients compatibles, sans clé.

Question technique sur l’API (contrat, limites, intégration) : support@mafactureok.com.