Adresse de l'API https://france-verification.com/api/v1

Suivre un envoi

GET /api/v1/submissions/{id}

Une analyse prend environ 10 secondes par document ; un gros envoi peut prendre quelques minutes. Deux façons de savoir quand c'est fini :

  1. Le webhook (recommandé) : nous appelons votre serveur avec l'évènement submission.completed dès que tout est terminé. Voir Webhooks.
  2. L'interrogation : relisez l'envoi jusqu'à ce que status vaille completed. Espacez les appels d'au moins 5 secondes.

Exemple

curl "https://france-verification.com/api/v1/submissions/sub_1842?detail=full" \
  -H "Authorization: Bearer $FV_API_KEY"

{
  "id": "sub_1842",
  "mode": "live",
  "status": "completed",
  "final_check": null,
  "documents_count": 1,
  "credits_charged": 1,
  "checks": [
    {
      "id": "chk_52817",
      "submission_id": "sub_1842",
      "type": "document",
      "status": "completed",
      "verdict": "SUSPECT",
      "confidence_score": 0.55,
      "document_type": "rib",
      "document_label": "Relevé d'identité bancaire",
      "filename": "rib.pdf",
      "page": null,
      "archive_name": null,
      "refunded": false,
      "created_at": "2026-09-28T14:49:06Z",
      "completed_at": "2026-09-28T14:49:17Z",
      "report_url": "https://france-verification.com/api/v1/checks/chk_52817/report.pdf",
      "details": {
        "analysis": "Le document présente la structure d'un RIB...",
        "positive_points": "Clé RIB valide, IBAN au bon format",
        "negative_points": "Police de l'IBAN différente du reste du document",
        "anomalies": "Métadonnées : fichier modifié après sa création",
        "recommendations": "Demander un RIB téléchargé directement depuis l'espace bancaire",
        "technical_quality": "bon"
      }
    }
  ],
  "created_at": "2026-09-28T14:49:06Z",
  "completed_at": "2026-09-28T14:49:17Z"
}

Quand un envoi est-il terminé ?

status passe à completed quand chaque vérification est completed ou failed et que la vérification de dossier éventuelle est close. Une vérification failed ne rend pas de verdict et son crédit est rendu (refunded: true) : vous pouvez renvoyer le fichier.

Lire le verdict

verdict Signification Action conseillée
CONFORME Aucune anomalie détectée. Accepter.
SUSPECT Des éléments demandent une vérification humaine. Relire details, demander une autre pièce.
NON-CONFORME Le document ne respecte pas les règles attendues pour son type (mentions manquantes, incohérences), ou ce n'est pas un document. Refuser ou demander une autre pièce.
FAKE Falsification détectée (logiciel de retouche, montage, métadonnées). Refuser.

confidence_score (de 0 à 1) mesure la confiance dans l'authenticité : plus il est haut, plus le document est jugé authentique. Il peut être null quand le document n'a pas pu être évalué (par exemple un fichier qui n'est pas un document).

Votre code doit décider sur verdict, jamais sur le texte de details, qui est rédigé pour un humain et peut changer de formulation.

Erreurs possibles

Statut Code Cause
404 not_found Identifiant inconnu, appartenant à un autre compte, ou envoi de test lu avec une clé live (et inversement).

Prêt à intégrer ? Créez votre clé test gratuitement : aucune analyse n'est facturée pendant le développement.

Créer ma clé API