API REST pour développeurs
API de vérification de passeport
Contrôlez les passeports transmis par vos clients ou candidats : page d'identité, bande MRZ, validité et retouches de l'image.
Ce que l'API contrôle
- Structure de la page d'identité selon le pays émetteur
- Bande MRZ et chiffres de contrôle
- Date d'expiration et cohérence des dates
- Retouches de l'image et incohérences typographiques
Les fraudes qu'elle repère
- MRZ incohérente avec le texte imprimé
- Passeport expiré présenté comme valide
- Photo remplacée
En trois étapes
- Envoyez le fichier (PDF, photo, archive ZIP) en une requête.
- Recevez le webhook signé quand l'analyse est terminée, environ 10 secondes plus tard.
- Décidez sur le verdict : CONFORME, SUSPECT, NON-CONFORME ou FAKE, avec le rapport PDF à archiver.
Envoyer le document
curl -X POST https://france-verification.com/api/v1/submissions \
-H "Authorization: Bearer $FV_API_KEY" \
-F "files[]=@passeport.pdf"
Le résultat
{
"id": "chk_52817",
"type": "document",
"status": "completed",
"verdict": "SUSPECT",
"confidence_score": 0.55,
"document_type": "passeport",
"document_label": "Passeport",
"refunded": false,
"report_url": "https://france-verification.com/api/v1/checks/chk_52817/report.pdf"
}
Même moteur que France Vérification : analyse par IA, contrôles forensiques du fichier et validations françaises (SIRET, IBAN, numéro de sécurité sociale).
Qui intègre cette vérification
- API de vérification de documents pour les banques et le crédit
- API de vérification de documents pour les recruteurs et ATS
Autres documents vérifiables par l'API
- API de vérification de fiche de paie
- API de vérification de RIB et d'IBAN
- API de vérification de relevé bancaire
- API de vérification de carte d'identité
- API de vérification de titre de séjour
- API de vérification de permis de conduire
- API de vérification de carte Vitale et d'attestation de droits
Questions fréquentes
Combien de temps prend la vérification d'un document de ce type ?
Environ 10 secondes. L'envoi répond immédiatement, puis un webhook vous prévient quand le verdict est prêt.
Combien coûte l'API ?
Le même prix que le site : un crédit par document vérifié (une page de PDF compte pour un document). Un fichier qui n'est pas un document, ou une analyse en échec, est remboursé automatiquement.
Peut-on tester sans payer ?
Oui : la clé de test (fv_test_) renvoie des résultats fictifs, sans crédit ni analyse, pour développer toute votre intégration.
Où sont traités les documents ?
Sur nos serveurs hébergés en France. Les fichiers sont effacés au bout de 7 jours, ou immédiatement avec la route DELETE /checks/{id}.