Développeurs

API de vérification

Tout ce que fait le site, votre logiciel peut le faire : envoyez un document, recevez les champs extraits, la vérification du 2D-Doc et le contrôle d’authenticité. Gratuit en bêta : demandez une clé par email, elle arrive aussitôt et reste stable. Les documents sont analysés puis supprimés, jamais conservés.

Ce que l’API vérifie exactement, et ce que cela prouve : le 2D-Doc expliqué →

Obtenir une clé (gratuit, immédiat)

En une instruction, depuis un terminal

Le paquet open source trustmydocs (SDK TypeScript, ligne de commande et serveur MCP, licence Apache-2.0) fait la même chose que les requêtes ci-dessous. Au premier lancement, il demande votre email, obtient la clé gratuite et la conserve sur votre machine ; ensuite une ligne suffit. Le code de sortie dit le verdict : 0 authentique, 2 mis en doute, 3 non vérifiable.

npx trustmydocs verify avis-imposition.pdf

Les vérifications disponibles

Une requête multipart/form-data par document, l’en-tête Authorization: Bearer <clé>, et la même réponse JSON que celle affichée par le site. Documentation interactive (Swagger) sur /api/docs.

Endpoint	Champs	Description
POST /api/v1/verify/tax	file	Avis d’imposition (PDF ou image) : lecture du 2D-Doc, vérification de la signature, extraction IA, contrôle « dernier avis » auprès de la DGFiP.
POST /api/v1/verify/2ddoc	file	Lecture d’un code 2D-Doc seul (PDF ou image) : champs signés et vérification du certificat émetteur.
POST /api/v1/verify/id	front, back (optionnel)	Carte nationale d’identité nouveau format : recto, verso optionnel.
POST /api/v1/verify/old-id	front, back (optionnel)	Carte nationale d’identité ancien format.
POST /api/v1/verify/passport	file	Passeport (image).
POST /api/v1/verify/payslip	file	Bulletin de paie (PDF ou image).
POST /api/v1/verify/generic	file	Tout autre document : classification et extraction des champs.
POST /api/v1/tenant-file	tax, payslip (répétable), id_front, id_back, old_id_front, old_id_back, passport, other	Dossier locataire complet en une requête (version salariés) : authenticité, cohérence identités/revenus, capacité locative, soit le même rapport que la page « Dossier locataire ». Quota : 1 unité par document analysé.
GET /api/v1/me	-	Plan et consommation de la clé présentée.

Exemple : vérifier un avis d’imposition

curl -X POST https://trustmydocs.com/api/v1/verify/tax \
  -H "Authorization: Bearer tmd_live_votre_cle" \
  -F "file=@avis-imposition.pdf"

Réponse (extrait)

{
  "success": true,
  "2d_doc_results": {
    "success": true,
    "certificate": { "verification": "OK" },
    "fiscal_fields": {
      "nomEtPrenomDuDeclarant1": "…",
      "numeroFiscalDuDeclarant1": "…",
      "referenceDAvisDImpot": "…",
      "revenuFiscalDeReference": "…",
      "anneeDesRevenus": "2023"
    },
    "Dernier avis ?": true
  },
  "llm_results": { "success": true, "extracted_fields": { "…": "…" } },
  "authenticity": true
}

Codes :: 200 · 401 (clé absente, invalide ou révoquée : demandez-en une ci-dessus) · 400 (fichier manquant ou format non pris en charge) · 429 avec Retry-After (quota bêta : 100 vérifications par jour et par clé) · 503 (traitement momentanément indisponible).
Plafond partagé :: La bêta est gratuite : l’ensemble des clés se partage 300 vérifications par jour, et le nombre de clés délivrées par jour est lui aussi plafonné. Au-delà, l’API répond 429 « service_quota_reached » et invite à revenir le lendemain ; le site, lui, reste ouvert. Le jour où ces plafonds gênent des usages réels, ils laisseront la place à des comptes.
Formats :: PDF, JPG, PNG, TIFF, BMP ; 32 Mo maximum par requête. La CNI ancien format est lue par OCR sur image (JPG ou PNG).
Valeur des résultats :: Seule la vérification de signature 2D-Doc est cryptographique. Extraction et « authenticité » proviennent de modèles probabilistes : un résultat est une aide, pas une preuve (voir les CGU).
Confidentialité :: Le document est analysé en mémoire sur nos serveurs européens, transmis le temps de l’analyse au fournisseur d’IA décrit dans la politique de confidentialité, puis supprimé. Votre email n’est conservé que pour la clé et le suivi d’usage.
Contrat :: Versionné et figé : un changement cassant passera par /v2/.

API de vérification

Obtenir une clé (gratuit, immédiat)

En une instruction, depuis un terminal

Les vérifications disponibles

Exemple : vérifier un avis d’imposition

Réponse (extrait)

Sans écrire de code

Automatiser avec Make ou n8n →

Connecteur ChatGPT et Claude →

Serveur MCP local pour les développeurs →