{"id":"a11b19e9-cdb2-4b1d-b9a7-364b2aec52bc","type":"API","name":"RIAL (Répertoire Inter-Administratif des Locaux)","slug":"rial-repertoire-inter-administratif-des-locaux","description":"Le RIAL (Répertoire Inter-Administratif des Locaux) s’appuie sur les données contenues dans R-Loc, le référentiel des locaux de la DGFIP. Ce référentiel a vocation à recenser l’ensemble des locaux présents sur le territoire national et partager leurs éléments d’évaluation avec les services fiscaux…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/rial-repertoire-inter-administratif-des-locaux","docs_url":"https://www.impots.gouv.fr/sites/default/files/media/1_metier/stats_et_donnees/api/docs-fonctionnelles-cgu/api-rial-documentation-fonctionnelle-v2026-05.pdf","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["taxation","government","geospatial","land"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/3b/06ce9c1027460a87364418789747b6-100.jpg","primary_source_url":"https://www.data.gouv.fr/dataservices/rial-repertoire-inter-administratif-des-locaux","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:45.719Z","updated_at":"2026-08-21T00:45:18.073Z","last_verified_at":"2026-08-18T00:39:50.012Z","deprecated_at":null,"ranking_score":61,"last_ranked_at":"2026-08-20T20:30:09.026Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'a':194B,196B 'access':113B,265B 'across':91B,243B 'administr':11A,76B,104B 'administratif':5A,20B,157A,172B 'administration':228B 'administrations':256B 'administrative':163A 'aim':84B 'aims':236B 'all':239B 'and':241B,254B,275B,283B,290B 'api':111B,263B 'appui':24B 'appuie':176B 'as':266B 'author':140B 'authorities':292B 'avec':61B,213B 'between':288B 'broader':118B,270B 'build':88B,146B 'building':298B 'building-level':145B,297B 'buildings':240B 'by':258B 'catalogu':86B 'catalogue':238B 'ce':40B,192B 'consist':144B 'consistent':296B 'contenu':28B 'contenues':180B 'coordin':135B 'coordination':287B 'd':59B,211B 'dan':29B 'dans':181B 'data':68B,148B,220B,300B 'databas':80B 'database':232B 'de':37B,189B 'des':6A,21B,35B,48B,158A,173B,187B,200B 'dgfip':39B,78B,191B,230B 'directori':12A 'directory':164A 'donnees':179B 'donné':27B 'draw':66B 'draws':218B 'effort':119B,271B 'element':98B 'elements':210B,250B 'ensembl':47B 'ensemble':199B 'et':55B,207B 'evaluation':212B 'fiscal':100B,252B 'fiscaux':64B,216B 'french':74B,108B,226B,260B 'from':221B 'geospati':151C 'govern':109B,150C 'government':261B 'in':279B 'inform':125B 'information':277B 'inter':4A,10A,19B,156A,162A,171B 'inter-administr':9A 'inter-administratif':3A,18B,155A,170B 'inter-administrative':161A 'it':235B 'l':46B,198B 'la':38B,190B 'land':132B,152C,284B 'le':15B,33B,52B,167B,185B,204B 'les':26B,62B,178B,214B 'leur':57B 'leurs':209B 'level':147B,299B 'loc':32B,72B,184B,224B 'local':139B,291B 'locaux':7A,22B,36B,49B,159A,174B,188B,201B 'manag':133B 'management':285B 'nation':54B,93B,137B 'national':206B,245B,289B 'of':165A,233B,268B 'on':219B,295B 'other':255B 'part':115B,267B 'partag':56B 'partager':208B 'plan':130B 'planning':282B 'premis':14A,82B,124B 'premises':166A,234B,276B 'presents':202B 'properti':122B 'property':274B 'provid':112B 'provides':264B 'présent':50B 'publish':105B 'published':257B 'r':31B,71B,183B,223B 'r-loc':30B,70B,182B,222B 'recens':45B 'recenser':197B 'refer':79B 'reference':231B 'referentiel':186B,193B 'reli':142B 'rely':294B 'repertoire':154A,169B 'rial':1A,8A,16B,65B,153A,160A,168B,217B 'référentiel':34B,41B 'répertoir':2A,17B 's':175B,229B 'servic':63B,101B 'services':215B,253B 'share':95B 'sharing':247B 'standard':121B 'standardize':273B 'support':134B 'supporting':286B 'sur':25B,51B,177B,203B 'tax':75B,227B 'taxat':128B,149C 'taxation':280B 'territoir':53B 'territoire':205B 'territori':94B 'territory':246B 'that':293B 'the':225B,244B,259B,262B,269B 'their':248B 'to':237B,272B 'unit':90B 'units':242B 'urban':129B,281B 'use':126B 'used':278B 'valuat':97B 'valuation':249B 'vocat':43B 'vocation':195B 'with':251B 'à':44B 'élément':58B 'évaluat':60B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"5b86827e-a848-4295-b242-91ac4e71dc2b","institution_type":"GOVERNMENT","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:45.719Z","geographic_scope":"NATIONAL","name_en":"RIAL (Inter-Administrative Directory of Premises)","description_en":"RIAL draws on data from R-Loc, the French tax administration's (DGFIP) reference database of premises. It aims to catalogue all buildings and units across the national territory, sharing their valuation elements with fiscal services and other administrations. Published by the French Government, the API provides access as part of the broader effort to standardize property and premises information used in taxation, urban planning, and land management, supporting coordination between national and local authorities that rely on consistent building-level data.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":61.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/main/swaggers/api-rial.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/main/swaggers/api-rial.json","source":"probe","runnable":true},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://www.impots.gouv.fr/sites/default/files/media/1_metier/stats_et_donnees/api/docs-fonctionnelles-cgu/api-rial-documentation-fonctionnelle-v2026-05.pdf","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/rial-repertoire-inter-administratif-des-locaux","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"a11b19e9-cdb2-4b1d-b9a7-364b2aec52bc","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":"5b86827e-a848-4295-b242-91ac4e71dc2b","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-22T19:53:48.613Z"},"api_details":{"id":"202c69ef-0b16-4d54-997c-fc45d83ad230","entry_id":"a11b19e9-cdb2-4b1d-b9a7-364b2aec52bc","base_url":null,"openapi_url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/main/swaggers/api-rial.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:45.737Z","updated_at":"2026-06-07T22:08:45.737Z"},"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":"726fdba9-0d7f-44ff-98af-15528bc4f026","entry_id":"a11b19e9-cdb2-4b1d-b9a7-364b2aec52bc","status":"VERIFIED","last_checked_at":"2026-08-18T00:39:49.667Z","p50_latency_ms":860,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:14.599Z","updated_at":"2026-08-18T00:39:49.667Z","consecutive_successes":49,"probe_url":"https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/main/swaggers/api-rial.json","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/plain; charset=utf-8","probe_succeeded_at":"2026-08-18T00:39:49.667Z"},"data_profile":{"id":"8848c62e-34b9-47dc-81b0-6656fe0d05b4","entry_id":"a11b19e9-cdb2-4b1d-b9a7-364b2aec52bc","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"identifiantFiscal","role":"parameter","type":"array","label":null,"param_in":"path","required":true,"container":"/locaux/{identifiantFiscal}","filterable":true,"description":"Identifiant fiscal du local (invariant) composé de 12 caractères : 5 caractères représentant les codes Insee département et commune + 7 caractères réprésentant un numéro séquentiel.\n\n_Exemple: 2A1810028562_\n\n--\n\n L'identifiant fiscal d'un local peut être récupéré en utilisant les deux autres opérati","description_en":"Invariant tax identifier of the premises, 12 characters (Insee codes plus sequence number)."},{"name":"codeDepartementInsee","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/adresseTopographique","filterable":true,"description":"Code Insee du département de situation du local (sur 2 caractères pour les départements métropolitains, sur 3 caractères pour les DOM)","description_en":"Insee code of the department where the premises is located."},{"name":"codeCommuneInsee","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/adresseTopographique","filterable":true,"description":"Code Insee de la commune de situation du bien (sur 3 caractères pour les départements métropolitains, sur 2 caractères pour les DOM). \n\n_NB : pour les communes de Lyon, Marseille et Paris, le code de la commune correspond au code Insee de l’arrondissement de situation du bien (exemple Paris, 20 arro","description_en":"Insee code of the municipality where the property is located."},{"name":"codeVoieTopo","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/adresseTopographique","filterable":true,"description":"Code topographique de la voie (Le fichier -Topo- géré par la DGFIP, anciennement fichier -Fantoir-, est mis à disposition sur data.gouv.fr). \n\n_NB : Le code topo de la voie est également restitué lors de la recherche d’une adresse sur le site national des adresses : https://adresse.data.gouv.fr/_","description_en":"Topographic (Fantoir/Topo) code identifying the street."},{"name":"numeroVoirie","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/adresseTopographique","filterable":true,"description":"Numéro de l’adresse dans la voie. Il est déterminé par les services municipaux et concerne les immeubles situés en bordure des voies publiques ou privées (ouvertes à la circulation publique)","description_en":"Street number of the address, assigned by municipal services."},{"name":"indiceRepetitionNumeroVoirie","role":"parameter","type":"string","label":null,"param_in":"query","container":"/locaux/adresseTopographique","filterable":true,"description":"Mention qui complète une numérotation de voirie. Il permet de différencier plusieurs adresses portant le même numéro dans la même voie","description_en":"Suffix distinguishing addresses sharing the same street number."},{"name":"etage","role":"parameter","type":"string","label":null,"param_in":"query","container":"/locaux/adresseTopographique","filterable":true,"description":"Donnée sur 2 caractères numériques destinée à identifier l’étage du local. Par convention le RDC est désigné par 00 et les niveaux en sous-sol par 81 (1er sous-sol), 82 (2ème sous-sol, …) Dans les immeubles collectifs, les dépendances de cave et parfois de stationnement peuvent détenir un numéro d’é","description_en":"Two-digit code for the floor level, ground floor coded 00."},{"name":"codeNatureLocal","role":"parameter","type":"string","label":null,"param_in":"query","container":"/locaux/adresseTopographique","filterable":true,"description":"Code décrivant la nature du local. \n\nPour les locaux d’habitation : \r\n- AP = appartement \r\n- DA = dépendance d’appartement \r\n- DE = dépendance bâtie isolée ou assimilée \r\n- DM = dépendance de maison \r\n- LC = locaux communs \r\n- MA = maison \r\n- MP = maison partagée (maison à cheval sur 2 communes). \n\n","enum_values":["AP","DA","DE","DM","LC","MA","MP","CB","AT","AU","CF","ME","SM","PP","SH","U","UE","UG","UN","NB"],"description_en":"Code indicating the type of premises, e.g. apartment or house."},{"name":"codeCommuneCadastral","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/parcelleCadastrale","filterable":true,"description":"Le code commune cadastral est toujours sur 3 caractères. Il est identique au code Insee de la commune lorsqu’elle est située dans un département métropolitain. Sinon, pour les communes situées dans les DOM, il est composé du code Insee de la commune, précédé du dernier chiffre du code département. \n","description_en":"Three-character cadastral commune code, usually matching the Insee code."},{"name":"codeCommuneAbsorbee","role":"parameter","type":"string","label":null,"param_in":"query","container":"/locaux/parcelleCadastrale","filterable":true,"description":"Dans le cas des fusions de communes, il s’agit du code cadastral de la commune absorbée, c.a.d. la commune originelle de situation géographique des biens. Exception : Pour Marseille et Toulouse il est renseigné avec le code quartier de la Commune","description_en":"Cadastral code of the original commune absorbed in a merger."},{"name":"codeSectionParcelle","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/parcelleCadastrale","filterable":true,"description":"La section cadastrale est l’une des composantes de la désignation cadastrale d’une parcelle. La section est un découpage infra-communal du plan cadastral. Le code section peut être composé de 1 à 2 lettres, ou, dans les départements d’alsace moselle composé de 2 chiffres","description_en":"Cadastral section code, a sub-communal division of the land registry."},{"name":"numeroPlanParcelle","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/locaux/parcelleCadastrale","filterable":true,"description":"Le numéro de plan est l’une des composantes de la désignation cadastrale d’une parcelle. Le numéro de plan est un découpage infra-section, il correspond à une portion de terrain d'un seul tenant appartenant à un même propriétaire. Il composé de 4 caractères numériques","description_en":"Four-digit plan number identifying the parcel within its section."},{"name":"etatLocal","type":"object","label":"local","description":"Informations sur l'état d'un local","description_en":"Information about the current status of the premises."},{"name":"adresseLocal","type":"object","label":"local","description":"Structure de l'adresse d'un local","description_en":"Structured address details of the premises."},{"name":"identifiantCadastral","type":"object","label":"local","description":"Informations d'identification cadastrale d'un local","description_en":"Cadastral identification information for the premises."},{"name":"lotCopropriete","type":"object","label":"local","description":"Lot de copropriété d'un local","description_en":"Condominium lot information for the premises."},{"name":"descriptifGeneralLocal","type":"object","label":"local","description":"Descriptif général d'un local","description_en":"General description of the premises."},{"name":"descriptifHabitation","type":"object","label":"local","description":"Eléments de description complémentaires dans le cas d'un local d'habitation","description_en":"Additional descriptive details for residential premises."},{"name":"descriptifLocalProfessionnel","type":"object","label":"local","description":"Eléments de description complémentaires dans le cas d'un local professionnel","description_en":"Additional descriptive details for professional/commercial premises."},{"name":"erreur","type":"object","label":"erreur","description":"Structure standard d'un message d'erreur","description_en":"Standard structure of an error message."}],"field_count":20,"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/main/swaggers/api-rial.json","curl":"curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/main/swaggers/api-rial.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:59:24.654Z","run_id":"084c640e-ac6e-4e23-8346-f4c4483e4c54","created_at":"2026-06-12T19:17:16.409Z","updated_at":"2026-07-21T23:59:24.654Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[],"manifest":{"answer_sha256":"76775c233add5930df1dc013629cad585c6663d8bf6cfe0f80552933e3d33983","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":31,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (20 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T19:53:48.661Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}