API REST pour développeurs
API de vérification de titre de séjour
Vérifiez les titres de séjour et récépissés avant une embauche ou une location : type de titre, droit au travail, validité et falsifications.
Ce que l'API contrôle
- Type de titre et mentions relatives au droit au travail
- Dates de validité et récépissés de renouvellement
- Bande MRZ et cohérence des informations
- Traces de modification du document
Les fraudes qu'elle repère
- Date de validité prolongée
- Mention « autorise son titulaire à travailler » ajoutée
- Récépissé falsifié
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[]=@titre-sejour.pdf"
Le résultat
{
"id": "chk_52817",
"type": "document",
"status": "completed",
"verdict": "SUSPECT",
"confidence_score": 0.55,
"document_type": "titre_sejour",
"document_label": "Titre de séjour",
"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 RH et les SIRH
- 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 passeport
- 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}.