API Recherche des personnes physiques (R2P)

L'API R2P permet aux entités administratives (administration, ministère, organisme public, collectivité) et aux acteurs privés qui sont éligibles d'obtenir les données personnelles d'un citoyen afin de les intégrer à leur Système d’Information (selon le cas d'usage : état civil complet, dernière adresse connue de l’administration fiscale (DGFIP) et identifiant fiscal ou SPI).

A quoi sert l’API R2P - Recherche des personnes physiques ?

Exemples de cas d'utilisation :

• pour une collectivité locale dans le cadre de la prise en charge d'une facture afin de fiabiliser l'état civil du débiteur ;
• pour une banque dans le cadre du contrôle de l'éligibilité des conditions d'ouverture d'un Livret d’Épargne Populaire (LEP).

Les données disponibles dans l'API

Cette API fait appel aux différents référentiels nationaux de la DGFiP afin de rechercher et de restituer des éléments relatifs à l'état civil et l'adresse d'un usager ; éléments fiables dont les états civils sont pour une grande majorité certifiés par l'INSEE (+99%) et les adresses conformes aux normes topographiques nationales.

Cas spécifique: les banques qui interrogent l’API dans le cadre du contrôle de l'éligibilité au Livret d’Épargne Populaire (LEP), ont seulement accès au SPI afin de pouvoir l’utiliser dans l’API Impôt particulier.

En savoir plus

L'API R2P propose 3 modes d'interrogation :

L'API R2P ne restitue qu'une seule personne.

Des messages d'erreur spécifiques sont restitués lorsque les éléments saisis peuvent correspondre à plusieurs personnes, lorsqu'aucune personne n'est trouvée, lorsque des éléments devant obligatoirement être saisis en entrée sont absents, ou lorsque le format des éléments saisis est erroné.