{"id":"daa14a6d-b5b5-4c6b-8258-e296b7e30aa5","type":"API","name":"API Recherche des personnes physiques (R2P)","slug":"api-recherche-des-personnes-physiques-r2p","description":"### 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…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-recherche-des-personnes-physiques-r2p","docs_url":"https://www.data.gouv.fr/dataservices/api-recherche-des-personnes-physiques-r2p","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["population","government"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/3b/06ce9c1027460a87364418789747b6-100.jpg","primary_source_url":"https://www.data.gouv.fr/dataservices/api-recherche-des-personnes-physiques-r2p","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:36.647Z","updated_at":"2026-08-15T21:03:09.776Z","last_verified_at":"2026-08-12T19:51:53.145Z","deprecated_at":null,"ranking_score":61,"last_ranked_at":"2026-08-03T15:32:11.974Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2025':79B,216B '30':77B,214B '30/09/2025':16B,152B 'a':149B,194B 'absorb':85B 'absorbed':222B 'acces':185B 'access':41B,92B,109B,229B,246B 'accessibles':177B 'accè':49B 'administr':122B 'administrative':259B 'and':248B,258B 'api':1A,10A,18B,30B,38B,44B,60B,89B,116B,137A,146A,154B,166B,174B,180B,197B,226B,253B 'are':236B 'as':212B 'attent':12B 'attention':148B 'been':221B 'capabilities':235B 'capabl':98B 'case':124B 'cases':261B 'catalogu':74B 'catalogue':211B 'concern':36B 'concernant':172B 'condit':110B 'conditions':247B 'd':48B,184B 'data.gouv.fr':72B,209B 'dataservic':73B 'dataservices':210B 'de':23B,25B,28B,159B,161B,164B 'demand':35B 'demandes':171B 'des':3A,139A 'direct':107B 'directly':244B 'dorenavant':168B 'dorénav':32B 'du':15B,151B 'et':50B,186B 'fonctionnalites':158B 'fonctionnalité':22B 'for':198B,231B,256B 'french':58B,132B,195B,269B 'function':82B 'functionality':219B 'govern':120B,136C 'government':257B 'handl':101B 'handled':238B 'has':220B 'inchanges':192B 'inchangé':56B 'individu':130B 'individuals':267B 'intend':118B 'intended':255B 'into':223B 'is':254B 'its':217B 'l':17B,29B,37B,43B,153B,165B,173B,179B 'les':21B,33B,46B,51B,157B,169B,182B,187B 'lookup':128B,265B 'mean':90B 'meaning':227B 'modalites':183B 'modalité':47B 'nation':59B 'national':196B 'natur':7A,65B 'natural':143A,202B 'new':91B,228B 'nouvell':34B 'nouvelles':170B 'now':237B 'of':201B,207B,213B,266B 'or':264B 'part':69B,206B 'partir':14B,150B 'person':8A,66B,68B,96B,233B 'person-search':95B,232B 'personn':4A,26B 'personne':162B 'personnes':140A 'persons':144A,203B,205B 'physic':67B 'physical':204B 'physiqu':5A,27B 'physique':163B 'physiques':141A 'popul':133B,135C 'population':270B 'pour':57B,193B 'pre':189B 'pre-requis':188B 'prerequisit':112B 'prerequisites':249B 'pré':53B 'pré-requi':52B 'r2p':6A,11A,31B,39B,106B,142A,147A,167B,175B,243B 'rather':104B,241B 'recherch':2A,24B 'recherche':138A,160B 'record':63B,134B 'records':200B,271B 'remain':113B,250B 'reprend':20B,156B 'request':93B 'requests':230B 'requi':54B 'requir':125B 'requiring':262B 'requis':190B 'restent':55B,191B 'search':9A,62B,81B,97B,145A,218B,234B 'searching':199B 'septemb':78B 'september':215B 'seront':40B,176B 'sfip':19B,45B,88B,103B,155B,181B,225B,240B 'than':242B 'the':208B,224B,252B 'though':108B,245B 'through':239B 'unchang':114B 'unchanged':251B 'use':123B,260B 'verif':126B 'verification':263B 'via':42B,178B 'within':131B,268B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":null,"institution_type":null,"country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:36.647Z","geographic_scope":"NATIONAL","name_en":"Natural Persons Search API (R2P)","description_en":"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.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":59.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json","source":"probe","runnable":true},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-recherche-des-personnes-physiques-r2p","source":"docs","runnable":false}],"formats":[]},"maturity":{"entry_id":"daa14a6d-b5b5-4c6b-8258-e296b7e30aa5","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":null,"definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-16T13:50:30.967Z"},"api_details":{"id":"aa79a6ff-e015-4b42-8952-1d1a0fbedde9","entry_id":"daa14a6d-b5b5-4c6b-8258-e296b7e30aa5","base_url":null,"openapi_url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":null,"created_at":"2026-06-07T22:08:36.667Z","updated_at":"2026-06-07T22:08:36.667Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"41576d6c-a401-4864-97bc-71b99075946d","entry_id":"daa14a6d-b5b5-4c6b-8258-e296b7e30aa5","status":"VERIFIED","last_checked_at":"2026-08-12T19:51:52.776Z","p50_latency_ms":1122,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:17.410Z","updated_at":"2026-08-12T19:51:52.776Z","consecutive_successes":29,"probe_url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/plain; charset=utf-8","probe_succeeded_at":"2026-08-12T19:51:52.776Z"},"data_profile":{"id":"38401404-ab4e-41ba-bc8e-20319892546f","entry_id":"daa14a6d-b5b5-4c6b-8258-e296b7e30aa5","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"prenom","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Prénom de naissance ou prénom d'usage  de la personne recherchée, 102 car. Max. par prénom","description_en":"First name (birth or usual) of the person searched for, max 102 characters."},{"name":"nom","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Nom  de naissance ou nom d'usage de la personne recherchée, 100 car. Max.","description_en":"Last name (birth or usual) of the person searched for, max 100 characters."},{"name":"sexe","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Valeur possible : 1 = masculin ou 2 = féminin. Format : 1 caractère numérique","description_en":"Sex code: 1 for male, 2 for female."},{"name":"naisDate","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Date de naissance, trois formats différents acceptés : AAAA, MM/AAAA, ou JJ/MM/AAAA","description_en":"Date of birth, in year, month/year, or day/month/year format."},{"name":"naisCodePays","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Code du pays sur 5 caractères numériques (cf nomenclature INSEE)","description_en":"INSEE country code of birth, 5 numeric digits."},{"name":"naisCodeDept","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Code du département à la date de naissance ou TOM. Format : 2 caractères (métropole), 3 caractères (TOM et DOM)","description_en":"Department or overseas territory code at time of birth."},{"name":"naisCodeCommune","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Code commune, 3 caractères numériques (métropole),  2 caractères numériques (TOM et DOM) (cf nomenclature INSEE)","description_en":"INSEE commune code of birth."},{"name":"adrCodePays","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Code du pays sur 5 caractères numériques (cf nomenclature INSEE)","description_en":"INSEE country code of the address, 5 numeric digits."},{"name":"adrCodeDept","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Code du département ou TOM. Format : 2 caractères alphanumérique (métropole) 3 caractères alphanumérique (TOM et DOM)","description_en":"Department or overseas territory code of the address."},{"name":"adrCodeCommune","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"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é","description_en":"Commune code of the address, from the INSEE nomenclature."},{"name":"adrLibelleVoie","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"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. ","description_en":"Street name of the address, max 26 alphanumeric characters."},{"name":"adrIndiceRepetition","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Indice de répétition de l’adresse (B = bis, T = ter, Q = quater)","description_en":"Address repetition index (B=bis, T=ter, Q=quater)."},{"name":"adrNumVoie","role":"parameter","type":"string","label":null,"param_in":"query","container":"/personne","filterable":true,"description":"Numéro de l’adresse","description_en":"Street number of the address."},{"name":"spi","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/personne/{spi}","filterable":true,"description":"spi","description_en":"Personal identification key (SPI) used to identify the person."},{"name":"cdPays","type":"string","label":"AdresseReponse","description":"Code INSEE du pays de l'adresse","description_en":"INSEE code of the address's country."},{"name":"lbPays","type":"string","label":"AdresseReponse","description":"Libellé du pays de l'adresse","description_en":"Name of the address's country."},{"name":"cdDepartement","type":"string","label":"AdresseReponse","description":"Code INSEE du département de l'adresse","description_en":"INSEE code of the address's department."},{"name":"lbDepartement","type":"string","label":"AdresseReponse","description":"Libellé du département de l'adresse","description_en":"Name of the address's department."},{"name":"cdTOM","type":"string","label":"AdresseReponse","description":"Code INSEE du TOM de l'adresse","description_en":"INSEE code of the address's overseas territory."},{"name":"lbTOM","type":"string","label":"AdresseReponse","description":"Libellé du TOM de l'adresse","description_en":"Name of the address's overseas territory."},{"name":"cdCommune","type":"string","label":"AdresseReponse","description":"Code INSEE de la commune de l'adresse","description_en":"INSEE code of the address's commune."},{"name":"lbCommune","type":"string","label":"AdresseReponse","description":"Libellé de la commune de l'adresse","description_en":"Name of the address's commune."},{"name":"cdVoie","type":"string","label":"AdresseReponse","description":"Code de la de la voie de l'adresse","description_en":"Code of the address's street."},{"name":"lbVoie","type":"string","label":"AdresseReponse","description":"Libellé de la voie de l'adresse","description_en":"Name of the address's street."},{"name":"numeroVoie","type":"string","label":"AdresseReponse","description":"Numéro de la voie de l'adresse","description_en":"Street number of the address."},{"name":"indiceDeRepetition","type":"string","label":"AdresseReponse","description":"Indice de répétion de l'adresse (B = bis, T = ter, Q = quater)","description_en":"Address repetition index (B=bis, T=ter, Q=quater)."},{"name":"complementAdresse","type":"string","label":"AdresseReponse","description":"complement adresse","description_en":"Additional address complement information."},{"name":"cdSexe","type":"string","label":"EtatCivilReponse","description":"Code du sexe de la personne : 1 masculin, 2 féminin","description_en":"Sex code of the person: 1 for male, 2 for female."},{"name":"lbNomNaissance","type":"string","label":"EtatCivilReponse","description":"nom de naissance","description_en":"Person's birth surname."},{"name":"lbPrenomNaissance","type":"string","label":"EtatCivilReponse","description":"Prénom de naissance","description_en":"Person's birth first name."},{"name":"lbNomUsage","type":"string","label":"EtatCivilReponse","description":"Nom d'usage","description_en":"Person's usual (used) surname."},{"name":"lbPrenomUsage","type":"string","label":"EtatCivilReponse","description":"Prénom d'usage","description_en":"Person's usual (used) first name."},{"name":"anneeNaissance","type":"string","label":"EtatCivilReponse","description":"Année de naissance au format AAAA","description_en":"Year of birth, in YYYY format."},{"name":"moisNaissance","type":"string","label":"EtatCivilReponse","description":"Mois de naissance au format MM","description_en":"Month of birth, in MM format."},{"name":"jourNaissance","type":"string","label":"EtatCivilReponse","description":"Jour de naissance au format JJ","description_en":"Day of birth, in DD format."},{"name":"cdPaysNaissance","type":"string","label":"EtatCivilReponse","description":"Code INSEE du pays de naissance","description_en":"INSEE code of the country of birth."},{"name":"cdDeptNaissance","type":"string","label":"EtatCivilReponse","description":"Code INSEE du département de naissance","description_en":"INSEE code of the department of birth."},{"name":"cdTOMNaissance","type":"string","label":"EtatCivilReponse","description":"Code INSEE du TOM de naissance","description_en":"INSEE code of the overseas territory of birth."},{"name":"cdCommuneNaissance","type":"string","label":"EtatCivilReponse","description":"cdCommuneNaissance","description_en":"INSEE code of the commune of birth."},{"name":"lieuNaissance","type":"object","label":"EtatCivilReponse","description":null,"description_en":"Structured information about the person's place of birth."},{"name":"cdCommuneAJour","type":"string","label":"LieuValeur","description":null,"description_en":"Current updated INSEE code of the commune."},{"name":"cdDept","type":"string","label":"LieuValeur","description":null,"description_en":"INSEE code of the department."},{"name":"cdDeptAJour","type":"string","label":"LieuValeur","description":null,"description_en":"Current updated INSEE code of the department."},{"name":"cdNatVoie","type":"string","label":"LieuValeur","description":null,"description_en":"Code identifying the type/nature of the street."},{"name":"cdPaysAJour","type":"string","label":"LieuValeur","description":null,"description_en":"Current updated INSEE code of the country."},{"name":"cdReg","type":"string","label":"LieuValeur","description":null,"description_en":"INSEE code of the region."},{"name":"cdRegAJour","type":"string","label":"LieuValeur","description":null,"description_en":"Current updated INSEE code of the region."},{"name":"cdVoieAJour","type":"string","label":"LieuValeur","description":null,"description_en":"Current updated code of the street."},{"name":"indRep","type":"string","label":"LieuValeur","description":null,"description_en":"Address repetition index (B=bis, T=ter, Q=quater)."},{"name":"lbCompAdres","type":"string","label":"LieuValeur","description":null,"description_en":"Additional address complement label."},{"name":"lbDept","type":"string","label":"LieuValeur","description":null,"description_en":"Name of the department."},{"name":"lbReg","type":"string","label":"LieuValeur","description":null,"description_en":"Name of the region."},{"name":"noVoie","type":"string","label":"LieuValeur","description":null,"description_en":"Street number."},{"name":"identifiant","type":"object","label":"PersonneReponse","description":null,"description_en":"Identifier information of the person."},{"name":"etatCivil","type":"object","label":"PersonneReponse","description":null,"description_en":"Civil status information of the person, such as name and birth details."},{"name":"adresse","type":"object","label":"PersonneReponse","description":null,"description_en":"Address information of the person."},{"name":"personnePhysique","type":"object","label":"PersonneReponseEnveloppe","description":null,"description_en":"Wrapper object containing the returned person's data."},{"name":"erreur","type":"object","label":"Erreur","description":null,"description_en":"Error information returned by the API."},{"name":"code","type":"string","label":"erreur","description":"Code de l'erreur","description_en":"Error code returned by the API."},{"name":"message","type":"string","label":"erreur","description":"Message de description de l'erreur","description_en":"Descriptive message of the error."},{"name":"horodatage","type":"string","label":"erreur","description":"Horodatage de l'erreur","description_en":"Timestamp of when the error occurred."},{"name":"codePostal","type":"string","label":"AdresseAvecCodePostalReponse","description":"codePostal","description_en":"Postal code of the address."},{"name":"descriptif","type":"string","label":"etatSante","description":"L'API est opérationnelle","description_en":"Status description indicating the API is operational."}],"field_count":63,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json","curl":"curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/SAADDGFIP2024-patch-2/swaggers/API-R2P.json' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."}],"status":"partial","error_message":null,"profiled_at":"2026-07-21T23:58:05.703Z","run_id":"7a09a0ec-552b-4600-99dd-da6e98424142","created_at":"2026-06-12T19:23:32.734Z","updated_at":"2026-07-21T23:58:05.703Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[]}