{"id":"452b884c-eb66-419c-b6e3-3333e21bba74","type":"API","name":"Base nationale des bâtiments","slug":"base-nationale-des-batiments","description":"Base nationale des bâtiments — official French public-data API published by RNB / BDNB (Bâtiment, Semestriel refresh).","free_access_class":"UNKNOWN","auth_type":"UNKNOWN","homepage_url":"https://www.bdnb.io/","docs_url":"https://www.bdnb.io/","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["construction","energy","geospatial"],"logo_url":"https://www.google.com/s2/favicons?sz=64&domain=bdnb.io","primary_source_url":"https://api.bdnb.io/v1/bdnb/donnees","extraction_confidence":"0.92","created_at":"2026-06-08T08:15:31.719Z","updated_at":"2026-08-22T18:14:23.286Z","last_verified_at":"2026-08-22T18:14:23.286Z","deprecated_at":null,"ranking_score":60,"last_ranked_at":"2026-08-20T16:25:42.028Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-21T12:49:15.118Z","search_vector":"'a':181B 'across':44B,151B 'aggreg':81B 'aggregates':188B 'an':139B 'analysi':94B 'analysis':201B 'and':158B,178B,189B,206B 'annual':77B,184B 'api':17B,38B,124B,145B 'applic':101B 'applications':208B 'at':209B 'base':1A,8B,26B,108A,115B,133B 'basi':78B 'basis':185B 'batiment':129B,176B 'batiments':111A,118B,136B 'bdnb':21B,30B,128B,137B 'build':6A,43B,91B 'building':198B 'buildings':113A,150B 'by':126B,164B,169B 'bâtiment':4A,11B,22B,29B,69B 'centr':64B 'centre':171B 'characterist':48B 'characteristics':155B 'construct':47B,96B,105C 'construction':154B,203B 'cross':84B,191B 'cross-refer':83B 'cross-references':190B 'cstb':70B,177B 'data':16B,37B,53B,123B,144B,160B 'databas':7A 'database':114A 'dataset':80B,187B 'des':3A,10B,28B,110A,117B,135B 'du':68B,175B 'energi':49B,97B,106C 'energy':156B,204B 'et':66B,173B 'franc':45B 'france':152B 'french':13B,34B,120B,141B 'geoloc':52B 'geolocation':159B 'geospati':100B,107C 'geospatial':207B 'in':202B 'includ':46B 'including':153B 'inform':41B 'information':148B 'initi':60B 'initiative':167B 'is':138B,162B 'it':161B 'maintain':61B 'maintained':168B 'multipl':86B 'multiple':193B 'nation':5A,87B,103B 'national':2A,9B,27B,112A,194B,210B 'nationale':109A,116B,134B 'offici':12B,33B 'official':119B,140B 'on':149B,180B,196B 'perform':50B 'performance':157B 'provid':39B 'providing':146B 'public':15B,36B,122B,143B 'public-data':14B,35B,121B,142B 'publish':18B,56B 'published':125B,163B 'refer':85B 'references':192B 'refresh':24B,72B,131B 'refreshed':179B 'renov':98B 'renovation':205B 'rnb':20B,127B 'rnb/bdnb':59B,166B 'scale':104B,211B 'scientifiqu':65B 'scientifique':172B 'semestriel':23B,130B 'semi':76B,183B 'semi-annu':75B 'semi-annual':182B 'sourc':88B 'sources':195B 'stock':92B,199B 'structur':40B 'structured':147B 'support':93B 'supporting':200B 'techniqu':67B 'technique':174B 'the':132B,165B,170B,186B,197B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"cc4f65c1-8f0f-42d7-ba35-a02d5ba41e75","institution_type":"AGENCY","country_code":"FR","official_confidence":92,"proof_summary":"Official RNB / BDNB source","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-08T08:15:31.719Z","geographic_scope":"NATIONAL","name_en":"National Buildings Database","description_en":"The Base nationale des bâtiments (BDNB) is an official French public-data API providing structured information on buildings across France, including construction characteristics, energy performance, and geolocation data. It is published by the RNB/BDNB initiative, maintained by the Centre scientifique et technique du bâtiment (CSTB), and refreshed on a semi-annual basis. The dataset aggregates and cross-references multiple national sources on the building stock, supporting analysis in construction, energy renovation, and geospatial applications at national scale.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"reference","trust_score":74.75,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.bdnb.io/v1/bdnb/donnees","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.bdnb.io/v1/bdnb/donnees","source":"probe","runnable":true},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://www.bdnb.io/","source":"docs","runnable":false}],"formats":[]},"maturity":{"entry_id":"452b884c-eb66-419c-b6e3-3333e21bba74","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":"verified","level_index":2,"level_label":"Verified","meaning":"Access tested successfully","counts_as_coverage":false,"blocked_by":null,"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":true,"reached":true,"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":false,"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":"per_item_proven","label":"Proven for this item: its own proof signals scored >= 80 AND it matched a registered public institution, so it would have been APPROVED on its own evidence.","proof_confidence":92,"proven_threshold":80,"institution_id":"cc4f65c1-8f0f-42d7-ba35-a02d5ba41e75","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":"api.bdnb.io","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-22T20:50:03.667Z"},"api_details":{"id":"5fa527b6-ff73-467a-b742-bba348fd70f2","entry_id":"452b884c-eb66-419c-b6e3-3333e21bba74","base_url":"https://api.bdnb.io/v1/bdnb/donnees","openapi_url":null,"graphql_url":null,"api_version":null,"spec_format":null,"endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://api.bdnb.io/v1/bdnb/donnees","created_at":"2026-06-08T08:15:31.740Z","updated_at":"2026-06-08T08:15:31.740Z"},"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":"dd1432b7-cd07-4c87-a12b-8d2558150b9e","entry_id":"452b884c-eb66-419c-b6e3-3333e21bba74","status":"VERIFIED","last_checked_at":"2026-08-22T18:14:22.973Z","p50_latency_ms":1623,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:09.929Z","updated_at":"2026-08-22T18:14:22.973Z","consecutive_successes":101,"probe_url":"https://api.bdnb.io/v1/bdnb/donnees","probe_method":"GET","probe_http_status":400,"probe_content_type":"application/json","probe_succeeded_at":"2026-08-22T18:14:22.973Z"},"data_profile":{"id":"488f1d71-67a0-40de-b380-d7ffb96593ed","entry_id":"452b884c-eb66-419c-b6e3-3333e21bba74","profile_source":"none","profile_kind":"dataset","dataset_id":null,"fields":null,"field_count":null,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":null,"status":"unsupported","error_message":"No introspectable source detected (primary URL sniffed: not machine-readable data)","profiled_at":"2026-07-20T14:24:10.160Z","run_id":"c4a8ed67-539e-48e0-b359-22e5c49ead4b","created_at":"2026-07-20T14:24:10.160Z","updated_at":"2026-07-20T14:24:10.160Z","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":"9c02a79af5405a2daed4ed5f4f946eff75f28e920aa1025903197c6cfdbd2ad7","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":9,"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: maturity.rungs[] (7 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T20:50:03.832Z","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."}}