API REST pour développeurs

API de vérification d'avis d'imposition

Contrôlez les avis d'imposition fournis pour une location ou un financement : revenu fiscal de référence, cohérence des montants et falsifications.

Ce que l'API contrôle

- Présence et cohérence du revenu fiscal de référence

- Numéro fiscal et référence de l'avis

- Cohérence des montants et de l'année d'imposition

- Traces d'édition du PDF

Les fraudes qu'elle repère

- Revenu fiscal de référence augmenté

- Avis d'une autre année présenté comme récent

- Avis entièrement fabriqué

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[]=@avis-imposition.pdf"

Le résultat

{
    "id": "chk_52817",
    "type": "document",
    "status": "completed",
    "verdict": "SUSPECT",
    "confidence_score": 0.55,
    "document_type": "avis_imposition",
    "document_label": "Avis d'imposition",
    "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}.