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).

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}.