Natural Persons Search API (R2P)API Recherche des personnes physiques (R2P)

Name: Natural Persons Search API (R2P)
Creator: data.gouv.fr

API Recherche des personnes physiques (R2P)Natural Persons Search API (R2P)

APIDiscovered1/7blocked by verifiedPreviewSubscribe🇫🇷France

French national API for searching records of natural persons (physical persons), part of the data.gouv.fr dataservices catalogue. As of 30 September 2025, its search functionality has been absorbed into the SFiP API, meaning new access requests for person-search capabilities are now handled through SFiP rather than R2P directly, though access conditions and prerequisites remain unchanged. The API is intended for government and administrative use cases requiring verification or lookup of individuals within French population records.### ATTENTION : **A partir du 30/09/2025, l'API SFiP reprend les fonctionnalités de recherche de personne physique de l'API R2P.** \ \ **Dorénavant, les nouvelles demandes concernant l'API R2P seront accessibles via l'API SFiP. Les modalités d'accès et les pré-requis restent inchangés pour a…

populationgovernment

Read the docs

Trust score

How is this computed?

good

Weighted across five axes. Tap a ring for what it measures.

Data schema (63 fields)

Filterable via the API (14)

prenomnomsexenaisDatenaisCodePaysnaisCodeDeptnaisCodeCommuneadrCodePaysadrCodeDeptadrCodeCommuneadrLibelleVoieadrIndiceRepetitionadrNumVoiespi

Field	Type	Description
prenom	string	First name (birth or usual) of the person searched for, max 102 characters.Prénom de naissance ou prénom d'usage de la personne recherchée, 102 car. Max. par prénom
nom	string	Last name (birth or usual) of the person searched for, max 100 characters.Nom de naissance ou nom d'usage de la personne recherchée, 100 car. Max.
sexe	string	Sex code: 1 for male, 2 for female.Valeur possible : 1 = masculin ou 2 = féminin. Format : 1 caractère numérique
naisDateNais date	string	Date of birth, in year, month/year, or day/month/year format.Date de naissance, trois formats différents acceptés : AAAA, MM/AAAA, ou JJ/MM/AAAA
naisCodePaysNais code pays	string	INSEE country code of birth, 5 numeric digits.Code du pays sur 5 caractères numériques (cf nomenclature INSEE)
naisCodeDeptNais code dept	string	Department or overseas territory code at time of birth.Code du département à la date de naissance ou TOM. Format : 2 caractères (métropole), 3 caractères (TOM et DOM)
naisCodeCommuneNais code commune	string	INSEE commune code of birth.Code commune, 3 caractères numériques (métropole), 2 caractères numériques (TOM et DOM) (cf nomenclature INSEE)
adrCodePaysAdr code pays	string	INSEE country code of the address, 5 numeric digits.Code du pays sur 5 caractères numériques (cf nomenclature INSEE)
adrCodeDeptAdr code dept	string	Department or overseas territory code of the address.Code du département ou TOM. Format : 2 caractères alphanumérique (métropole) 3 caractères alphanumérique (TOM et DOM)
adrCodeCommuneAdr code commune	string	Commune code of the address, from the INSEE nomenclature.Code commune, 3 caractères numériques (métropole). Ce code commune correspond au 3 derniers caractères du code INSEE de la commune. 2 caractères numériques (TOM et DOM) (cf nomenclature INSEE) . Cette zone ne peut être valorisée que si un département Métropole ou DOM est précisé
adrLibelleVoieAdr libelle voie	string	Street name of the address, max 26 alphanumeric characters.26 caractères alphanumériques. Cette zone ne peut être valorisée que si que si un département Métropole ou DOM et une commune sont précisés.
adrIndiceRepetitionAdr indice repetition	string	Address repetition index (B=bis, T=ter, Q=quater).Indice de répétition de l’adresse (B = bis, T = ter, Q = quater)
adrNumVoieAdr num voie	string	Street number of the address.Numéro de l’adresse
spi	string	Personal identification key (SPI) used to identify the person.spi
cdPaysAdresseReponse	string	INSEE code of the address's country.Code INSEE du pays de l'adresse
lbPaysAdresseReponse	string	Name of the address's country.Libellé du pays de l'adresse
cdDepartementAdresseReponse	string	INSEE code of the address's department.Code INSEE du département de l'adresse
lbDepartementAdresseReponse	string	Name of the address's department.Libellé du département de l'adresse
cdTOMAdresseReponse	string	INSEE code of the address's overseas territory.Code INSEE du TOM de l'adresse
lbTOMAdresseReponse	string	Name of the address's overseas territory.Libellé du TOM de l'adresse
cdCommuneAdresseReponse	string	INSEE code of the address's commune.Code INSEE de la commune de l'adresse
lbCommuneAdresseReponse	string	Name of the address's commune.Libellé de la commune de l'adresse
cdVoieAdresseReponse	string	Code of the address's street.Code de la de la voie de l'adresse
lbVoieAdresseReponse	string	Name of the address's street.Libellé de la voie de l'adresse
numeroVoieAdresseReponse	string	Street number of the address.Numéro de la voie de l'adresse
indiceDeRepetitionAdresseReponse	string	Address repetition index (B=bis, T=ter, Q=quater).Indice de répétion de l'adresse (B = bis, T = ter, Q = quater)
complementAdresseAdresseReponse	string	Additional address complement information.complement adresse
cdSexeEtatCivilReponse	string	Sex code of the person: 1 for male, 2 for female.Code du sexe de la personne : 1 masculin, 2 féminin
lbNomNaissanceEtatCivilReponse	string	Person's birth surname.nom de naissance
lbPrenomNaissanceEtatCivilReponse	string	Person's birth first name.Prénom de naissance
lbNomUsageEtatCivilReponse	string	Person's usual (used) surname.Nom d'usage
lbPrenomUsageEtatCivilReponse	string	Person's usual (used) first name.Prénom d'usage
anneeNaissanceEtatCivilReponse	string	Year of birth, in YYYY format.Année de naissance au format AAAA
moisNaissanceEtatCivilReponse	string	Month of birth, in MM format.Mois de naissance au format MM
jourNaissanceEtatCivilReponse	string	Day of birth, in DD format.Jour de naissance au format JJ
cdPaysNaissanceEtatCivilReponse	string	INSEE code of the country of birth.Code INSEE du pays de naissance
cdDeptNaissanceEtatCivilReponse	string	INSEE code of the department of birth.Code INSEE du département de naissance
cdTOMNaissanceEtatCivilReponse	string	INSEE code of the overseas territory of birth.Code INSEE du TOM de naissance
cdCommuneNaissanceEtatCivilReponse	string	INSEE code of the commune of birth.cdCommuneNaissance
lieuNaissanceEtatCivilReponse	object	Structured information about the person's place of birth.Structured information about the person's place of birth.
cdCommuneAJourLieuValeur	string	Current updated INSEE code of the commune.Current updated INSEE code of the commune.
cdDeptLieuValeur	string	INSEE code of the department.INSEE code of the department.
cdDeptAJourLieuValeur	string	Current updated INSEE code of the department.Current updated INSEE code of the department.
cdNatVoieLieuValeur	string	Code identifying the type/nature of the street.Code identifying the type/nature of the street.
cdPaysAJourLieuValeur	string	Current updated INSEE code of the country.Current updated INSEE code of the country.
cdRegLieuValeur	string	INSEE code of the region.INSEE code of the region.
cdRegAJourLieuValeur	string	Current updated INSEE code of the region.Current updated INSEE code of the region.
cdVoieAJourLieuValeur	string	Current updated code of the street.Current updated code of the street.
indRepLieuValeur	string	Address repetition index (B=bis, T=ter, Q=quater).Address repetition index (B=bis, T=ter, Q=quater).
lbCompAdresLieuValeur	string	Additional address complement label.Additional address complement label.
lbDeptLieuValeur	string	Name of the department.Name of the department.
lbRegLieuValeur	string	Name of the region.Name of the region.
noVoieLieuValeur	string	Street number.Street number.
identifiantPersonneReponse	object	Identifier information of the person.Identifier information of the person.
etatCivilPersonneReponse	object	Civil status information of the person, such as name and birth details.Civil status information of the person, such as name and birth details.
adressePersonneReponse	object	Address information of the person.Address information of the person.
personnePhysiquePersonneReponseEnveloppe	object	Wrapper object containing the returned person's data.Wrapper object containing the returned person's data.
erreur	object	Error information returned by the API.Error information returned by the API.
codeerreur	string	Error code returned by the API.Code de l'erreur
messageerreur	string	Descriptive message of the error.Message de description de l'erreur
horodatageerreur	string	Timestamp of when the error occurred.Horodatage de l'erreur
codePostalAdresseAvecCodePostalReponse	string	Postal code of the address.codePostal
descriptifetatSante	string	Status description indicating the API is operational.L'API est opérationnelle

Schema captured from openapi 26 days ago.

Verification Status

Using the API

Configuration

Format: openapi

Query examples

curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json' -H 'Accept: application/json'

Machine-readable API description (use it to generate clients).

Full API documentation ↗

Machine-readable & source

OpenAPI spec JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.