API Greenloc
API de vérification des dossiers locataires
Le moteur de vérification intégré à l'outil Greenloc est aussi accessible par API. Contrôle des pièces, détection des faux documents et vérification à la source se branchent directement dans votre parcours de candidature.
Pensée pour les volumes de 5 000 dossiers par an et plus. Sur devis, selon vos volumes.
Mise à jour :
Quels sont les repères clés de l'API de vérification Greenloc ?
- 2appelsUn au dépôt de chaque pièce, un au dossier complet.
- 2niveauxDe vérification : contrôle des pièces sur chaque dossier, vérification à la source en option.
- 2 000+Règles de contrôle améliorées chaque mois à partir de plus de 2 000 dossiers réels.
- 5 000+Dossiers par an : le volume pour lequel l'API est pensée.
Définition
Qu'est-ce que l'API de vérification Greenloc ?
L'API de vérification de dossiers locataires Greenloc est une interface qui permet à votre logiciel ou à votre parcours de candidature d'envoyer les pièces d'un candidat et de recevoir un résultat de contrôle structuré, pièce par pièce puis pour le dossier complet. C'est le même moteur que celui intégré nativement à l'outil Greenloc.
Pourquoi vérifier les dossiers de façon automatisée ?
- La fraude documentaire progresse. Les faux générés ou retouchés par IA sont souvent invisibles à l'œil nu ; seul un contrôle du fichier et de son contenu les fait apparaître.
- Le candidat dépose lui-même ses pièces. Imprimer puis rescanner un document efface ses métadonnées ; le dépôt direct du fichier d'origine les préserve pour l'analyse.
- L'agent garde la décision. La vérification complète son jugement sans le remplacer, et le rapport devient un argument à présenter au propriétaire.
Outil Greenloc ou API : quel accès choisir ?
La vérification est native dans l'outil Greenloc et accessible par API. Le moteur est le même ; seul le point d'entrée change.
Natif
L'outil Greenloc
Pour les agences qui veulent recevoir, trier et vérifier leurs candidatures dans une interface prête à l'emploi.
- Parcours de candidature et dépôt des pièces par le candidat
- Vérification intégrée et rapport lisible par l'agent comme par le propriétaire
- Aucun développement nécessaire
- Essai gratuit, puis abonnement à partir de 59 € HT/mois
API
L'API de vérification Greenloc
Pour les structures qui ont déjà leur parcours de candidature ou leur logiciel et veulent y brancher la vérification.
- Deux appels : au dépôt de chaque pièce, puis au dossier complet
- Résultat structuré en JSON et rapport de vérification en PDF
- Pensée pour les volumes de 5 000 dossiers par an et plus
- Sur devis, selon vos volumes
Contrôles
Quels documents l'API Greenloc vérifie-t-elle ?
L'API de vérification de dossiers locataires Greenloc contrôle les pièces d'identité, les bulletins de paie et les avis d'imposition, détecte les signes de fraude documentaire et peut vérifier les revenus directement à la source. Chaque contrôle renvoie un statut et un motif lisible, pièce par pièce, puis à l'échelle du dossier complet.
Pièce d'identité
- Lecture de la pièce
- Contrôle de la bande MRZ
- Vérification de la date de validité
- Cohérence avec les autres pièces du dossier
Bulletins de paie
- Cohérence des salaires et des cumuls
- Vérification de l'employeur par son numéro SIRET
Avis d'imposition
- Lecture de l'avis
- Vérification du code 2D-Doc, le cachet électronique apposé par l'administration fiscale (DGFiP)
Détection de fraude
- Analyse des métadonnées du fichier
- Repérage des retouches et des textes modifiés
- Incohérences entre les documents du dossier
Vérification à la source
- Open banking, dans le cadre de la directive DSP2
- Sources administratives via FranceConnect
- Toujours avec le consentement du candidat
Règles de contrôle améliorées chaque mois à partir de plus de 2 000 dossiers réels. Elles profitent autant à l'outil Greenloc qu'à l'API, puisque c'est le même moteur.
Deux niveaux
Quels sont les deux niveaux de vérification de l'API Greenloc ?
L'API de vérification de dossiers locataires Greenloc fonctionne sur deux niveaux. Le niveau 1 s'applique à chaque dossier : contrôle des pièces, complétude, cohérence et détection des faux de premier niveau. Le niveau 2, en option, vérifie à la source les dossiers retenus, par FranceConnect ou open banking, avec le consentement du candidat.
Niveau 1 : contrôle du dossier
Sur chaque dossier
- Contrôle de chaque pièce dès son dépôt
- Complétude du dossier
- Cohérence des informations déclarées avec les pièces
- Détection des faux de premier niveau : textes modifiés, incohérences, vérification de l'avis d'imposition
Niveau 2 : vérification à la source
Sur les dossiers retenus
- Vérification par FranceConnect ou par open banking
- Revenus mensuels du candidat, ou historique de bon payeur pour un ancien locataire
- Pour un étudiant, seul le garant est vérifié
- Toujours avec le consentement du candidat
Intégration
Comment intégrer l'API de vérification Greenloc ?
L'intégration de l'API de vérification de dossiers locataires Greenloc repose sur deux appels : le premier à chaque dépôt de pièce, qui accepte ou refuse la pièce immédiatement, le second quand le dossier est complet, qui renvoie le score et le détail des contrôles en JSON, accompagnés d'un rapport de vérification en PDF.
-
Le candidat dépose son dossier
Il dépose ses pièces dans votre propre parcours de candidature, sur votre site ou dans votre logiciel.
-
Chaque pièce est contrôlée au dépôt
La pièce est transmise à Greenloc et refusée tout de suite si elle ne convient pas. Le candidat la remplace sans intervention de vos équipes.
Appel 1
-
Le dossier complet est vérifié
Vérification de niveau 1 sur les informations déclarées et les pièces, puis analyse globale du dossier par recoupement.
Appel 2
-
Vous recevez le score
Le score du dossier est fourni en PDF ou directement par API. Sur le dossier sélectionné, vous déclenchez la vérification de niveau 2 si vous le souhaitez.
Exemple d'appel à l'API
Hôte : api.greenloc-immo.com · Authentification par jeton Bearer
1. Dépôt d'une pièce
Requête
curl -X POST https://api.greenloc-immo.com/v1/documents \
-H "Authorization: Bearer VOTRE_CLE_API" \
-F "dossier_id=dos_8F2K41" \
-F "type=bulletin_de_paie" \
-F "fichier=@bulletin-octobre.pdf"
Réponse si la pièce est acceptée
{
"document_id": "doc_31QZ7",
"dossier_id": "dos_8F2K41",
"type": "bulletin_de_paie",
"statut": "accepte",
"motif": null
}
Réponse si la pièce est refusée
{
"document_id": "doc_31QZ8",
"dossier_id": "dos_8F2K41",
"type": "bulletin_de_paie",
"statut": "refuse",
"motif": "Document incomplet : une seule page transmise sur deux",
"action": "remplacement_demande"
}
2. Dossier complet
Requête
curl -X POST https://api.greenloc-immo.com/v1/dossiers/dos_8F2K41/verification \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{ "niveau": 1 }'
Réponse
Réponse sur le dossier complet
{
"dossier_id": "dos_8F2K41",
"niveau": 1,
"statut": "termine",
"score": 78,
"controles": {
"identite": { "statut": "verifie" },
"bulletins_de_paie": { "statut": "verifie", "siret_employeur": "verifie" },
"avis_imposition": { "statut": "verifie", "code_2d_doc": "valide" },
"fraude": { "statut": "anomalie" },
"coherence": { "statut": "verifie" }
},
"anomalies": [
{
"document_id": "doc_31QZ9",
"axe": "fraude",
"motif": "Métadonnées : fichier modifié après sa date de création"
}
],
"rapport_pdf": "https://api.greenloc-immo.com/v1/dossiers/dos_8F2K41/rapport.pdf"
}
Exemple illustratif ; la documentation complète est remise lors de l'échange technique.
Pour qui
À qui s'adresse l'API de vérification Greenloc ?
L'API de vérification de dossiers locataires Greenloc s'adresse aux structures qui traitent un grand nombre de candidatures : réseaux d'agences, administrateurs de biens, éditeurs de logiciels immobiliers, plateformes de location, assureurs et courtiers. Elle est pensée pour les volumes de 5 000 dossiers par an et plus ; en dessous, l'outil Greenloc natif est souvent plus simple.
Réseaux d'agences et administrateurs de biens
Un même niveau de contrôle dans toutes vos agences, branché sur votre parcours de candidature existant, avec un rapport à présenter au propriétaire.
Éditeurs de logiciels immobiliers
Ajoutez la vérification documentaire à votre logiciel sans développer votre propre moteur de contrôle. Vos utilisateurs restent dans votre interface.
Plateformes de location
Chaque pièce est contrôlée au moment où le candidat la dépose ; une pièce refusée est remplacée par le candidat lui-même.
Assureurs et courtiers
Appuyez vos décisions sur des dossiers dont les pièces ont été contrôlées, avec un résultat structuré axe par axe.
Moins de 5 000 dossiers par an ? L'outil Greenloc intègre le même moteur de vérification, sans développement : essai gratuit, puis abonnement à partir de 59 € HT/mois.
Découvrir l'outil GreenlocSécurité et RGPD
Comment l'API Greenloc protège-t-elle les données des candidats ?
L'API de vérification de dossiers locataires Greenloc traite les pièces dans un cadre dédié à la vérification, sans passer par une IA publique généraliste. Seules les pièces autorisées par le décret du 5 novembre 2015 sont demandées, et la vérification à la source de niveau 2 n'a lieu qu'avec le consentement du candidat.
- Un traitement dédié à la vérificationLes pièces transmises à l'API servent à vérifier le dossier du candidat.
- Aucune IA publique généralisteEnvoyer un dossier locataire à un assistant IA grand public engage la responsabilité de l'agence au titre du RGPD. Greenloc ne fait pas transiter les pièces par ce type de service.
- Seulement les pièces autoriséesLes pièces demandées au candidat respectent la liste fixée par le décret du 5 novembre 2015.
- Le consentement pour le niveau 2La vérification à la source, par FranceConnect ou par open banking dans le cadre de la DSP2, n'est lancée qu'avec l'accord du candidat.
- Le fichier d'origine, déposé par le candidatLe dépôt direct préserve les métadonnées que l'impression puis le rescan effaceraient.
- Un cadre précisé au contratLes modalités d'hébergement, les durées de conservation et les délais de réponse sont précisés dans la documentation remise lors de l'échange technique.
Cadre de référence : RGPD, recommandations de la CNIL, décret du 5 novembre 2015 sur les pièces justificatives, code 2D-Doc des avis d'imposition (DGFiP), FranceConnect, DSP2.
FAQ
Quelles sont les questions fréquentes sur l'API de vérification Greenloc ?
Cette FAQ réunit les questions posées le plus souvent sur l'API de vérification de dossiers locataires Greenloc : différence avec l'outil Greenloc, documents contrôlés, détection des faux, usage des IA publiques, volumes concernés et tarification sur devis. Chaque réponse peut se lire indépendamment des autres.
Peut-on analyser un dossier locataire avec une IA publique ?
Ce n'est pas recommandé. Envoyer les pièces d'un candidat à un assistant IA public généraliste revient à transmettre des données personnelles à un service qui n'a pas été choisi pour ce traitement, et l'agence en reste responsable au titre du RGPD. Un outil dédié, comme l'outil ou l'API de vérification Greenloc, traite les pièces dans un cadre prévu pour la vérification.
Combien coûte l'API de vérification Greenloc ?
L'API de vérification de dossiers locataires Greenloc est proposée sur devis, selon vos volumes de dossiers et le niveau de vérification retenu. Le plus simple est de planifier un échange de 20 minutes pour estimer ensemble votre volume annuel.
Quelle différence entre l'outil Greenloc et l'API ?
Le moteur de vérification est le même. L'outil Greenloc est une interface prête à l'emploi pour recevoir, trier et vérifier les candidatures. L'API branche ce moteur dans votre propre parcours ou votre logiciel, avec deux appels et des résultats en JSON ou en PDF.
L'API détecte-t-elle les fausses fiches de paie ?
Oui. L'API Greenloc contrôle la cohérence des salaires et des cumuls, vérifie l'employeur par son numéro SIRET, analyse les métadonnées du fichier et repère les retouches et les textes modifiés. Elle signale aussi les incohérences avec les autres pièces du dossier, comme l'avis d'imposition.
Comment vérifier un avis d'imposition par API ?
L'avis d'imposition est déposé comme les autres pièces, par l'appel de dépôt. Greenloc lit l'avis et vérifie son code 2D-Doc, le cachet électronique apposé par l'administration fiscale. Le résultat apparaît dans la réponse sur le dossier complet, sur l'axe avis d'imposition.
À partir de quel volume l'API est-elle pertinente ?
L'API est pensée pour les volumes de 5 000 dossiers par an et plus : réseaux d'agences, administrateurs de biens, éditeurs de logiciels immobiliers, plateformes de location, assureurs et courtiers. En dessous, l'outil Greenloc natif offre le même moteur sans développement, avec un essai gratuit puis un abonnement à partir de 59 € HT/mois.
Combien d'appels faut-il pour vérifier un dossier ?
Deux. Un appel à chaque dépôt de pièce, qui accepte ou refuse la pièce avec un motif, et un appel quand le dossier est complet, qui renvoie le score, le niveau de vérification, les contrôles par axe, les anomalies et le lien du rapport PDF.
Qu'est-ce que la vérification à la source de niveau 2 ?
C'est une vérification optionnelle, réalisée sur les dossiers retenus, par FranceConnect ou par open banking. Elle confirme les revenus mensuels du candidat, ou son historique de bon payeur s'il est déjà locataire. Pour un étudiant, seul le garant est vérifié. Elle n'a lieu qu'avec le consentement du candidat.
L'API remplace-t-elle le jugement de l'agent immobilier ?
Non. La vérification complète le jugement de l'agent sans le remplacer : elle signale les anomalies et leur motif, l'agent décide. Le rapport de vérification est aussi un argument à présenter au propriétaire.
Les contrôles de l'API évoluent-ils dans le temps ?
Oui. Règles de contrôle améliorées chaque mois à partir de plus de 2 000 dossiers réels. Ces évolutions profitent autant à l'outil Greenloc qu'à l'API, puisque c'est le même moteur.
Échange de 20 minutes
L'API de vérification Greenloc est-elle adaptée à votre volume ?
En 20 minutes, l'équipe Greenloc fait le point avec vous sur votre volume de dossiers, votre parcours de candidature et le niveau de vérification utile, puis vous indique si l'API de vérification de dossiers locataires Greenloc ou l'outil Greenloc natif répond le mieux à votre besoin. L'API est proposée sur devis, selon vos volumes.

