API REST pour développeurs

API de vérification de justificatif de domicile

Vérifiez les factures d'énergie, de téléphone et autres justificatifs de domicile : émetteur, date, adresse et retouches.

Ce que l'API contrôle

- Émetteur identifié et mise en page cohérente avec ses factures réelles

- Date de moins de 3 mois

- Adresse et titulaire cohérents avec le reste du dossier

- Adresse ou nom modifiés dans le fichier

Les fraudes qu'elle repère

- Adresse remplacée sur une vraie facture

- Justificatif généré en ligne

- Facture ancienne redaté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[]=@justificatif-domicile.pdf"

Le résultat

{
    "id": "chk_52817",
    "type": "document",
    "status": "completed",
    "verdict": "SUSPECT",
    "confidence_score": 0.55,
    "document_type": "justificatif_domicile",
    "document_label": "Justificatif de domicile",
    "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}.