{"id":"2e975fba-a9ec-4cb7-8c66-943813eca93c","type":"API","name":"Cavités souterraines","slug":"cavites-souterraines","description":"Cavités souterraines — official French public-data API published by Géorisques (Environnement, Mensuel refresh).","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.georisques.gouv.fr/donnees/bases-de-donnees/inventaire-des-cavites-souterraines","docs_url":"https://www.georisques.gouv.fr/donnees/bases-de-donnees/inventaire-des-cavites-souterraines","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["environment","land"],"logo_url":"https://www.google.com/s2/favicons?sz=64&domain=georisques.gouv.fr","primary_source_url":"https://www.georisques.gouv.fr/api/v1/cavites","extraction_confidence":"0.92","created_at":"2026-06-08T08:15:30.664Z","updated_at":"2026-09-27T08:56:35.222Z","last_verified_at":"2026-09-27T08:49:46.002Z","deprecated_at":null,"ranking_score":53,"last_ranked_at":"2026-09-27T08:51:03.475Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-09-27T08:56:35.222Z","search_vector":"'api':10B,28B 'by':30B 'cavites':19A,21B 'cavité':1A,3B 'data':9B,27B 'environ':17C 'environn':14B 'environnement':32B 'french':6B,24B 'georisques':31B 'géorisqu':13B 'land':18C 'mensuel':15B,33B 'offici':5B 'official':23B 'public':8B,26B 'public-data':7B,25B 'publish':11B 'published':29B 'refresh':16B,34B 'souterrain':2A,4B 'souterraines':20A,22B","popularity_score":"0.0000","maintenance_score":"0.6000","institution_id":"5b86827e-a848-4295-b242-91ac4e71dc2b","institution_type":"GOVERNMENT","country_code":"FR","official_confidence":92,"proof_summary":"Official Géorisques source","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-08T08:15:30.664Z","geographic_scope":"NATIONAL","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"sample","trust_score":74.75,"merged_into_entry_id":null,"identity_key":"API|https://www.georisques.gouv.fr/api/v1/cavites|cavités souterraines","upstream_ref":null,"access":{"level":"direct","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://www.georisques.gouv.fr/api/v1/cavites?code_insee=51454","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://www.georisques.gouv.fr/api/v1/cavites?code_insee=51454","source":"probe","runnable":true},{"kind":"query","label":"API base URL","method":"GET","url":"https://www.georisques.gouv.fr","source":"base_url","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://www.georisques.gouv.fr/donnees/bases-de-donnees/inventaire-des-cavites-souterraines","source":"docs","runnable":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://www.georisques.gouv.fr/api/v1/cavites","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"2e975fba-a9ec-4cb7-8c66-943813eca93c","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":"profiled","level_index":3,"level_label":"Profiled","meaning":"Schema, dimensions and licence understood","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":true,"reached":true,"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":"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.georisques.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-09-27T11:43:45.230Z"},"api_details":{"id":"62a9e1cc-22ef-43fa-805c-490064bf5c40","entry_id":"2e975fba-a9ec-4cb7-8c66-943813eca93c","base_url":"https://www.georisques.gouv.fr","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://www.georisques.gouv.fr/api/v1/cavites?code_insee=51454","created_at":"2026-06-08T08:15:30.684Z","updated_at":"2026-09-27T08:32:45.956Z"},"dataset_details":null,"license":{"id":"lo-2.0","spdx_id":"etalab-2.0","name":"Licence Ouverte 2.0 (France / Etalab)","url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"national","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"reuse":{"license_id":"lo-2.0","license_name":"Licence Ouverte 2.0 (France / Etalab)","license_url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Texte de la licence - le reutilisateur est libre \"de la communiquer, la reproduire, la copier ; de l'adapter, la modifier, l'extraire et la transformer, notamment pour creer des Informations derivees ; de la diffuser, la redistribuer, la publier et la transmettre, de l'exploiter a titre commercial\". Seule obligation : \"mentionner la paternite de l'Information : sa source (a minima le nom du Concedant) et la date de la derniere mise a jour\". Le texte rappelle que le reutilisateur doit respecter \"le cadre legal relatif a la protection des donnees a caractere personnel\". Aucune clause de partage a l'identique n'est imposee.","source_url":"https://github.com/etalab/licence-ouverte/blob/master/LO.md","reviewed_at":null},"license_raw":"etalab-2.0","latest_check":{"id":"49d39eda-5be5-4827-8f15-898aee07c55d","entry_id":"2e975fba-a9ec-4cb7-8c66-943813eca93c","status":"VERIFIED","last_checked_at":"2026-09-27T08:49:45.751Z","p50_latency_ms":1314,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:08.879Z","updated_at":"2026-09-27T08:49:45.751Z","consecutive_successes":1,"probe_url":"https://www.georisques.gouv.fr/api/v1/cavites?code_insee=51454","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json","probe_succeeded_at":"2026-09-27T08:49:45.751Z"},"data_profile":{"id":"9790f180-6118-44c1-9368-8807e41e96a9","entry_id":"2e975fba-a9ec-4cb7-8c66-943813eca93c","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"code_insee","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/cavites","filterable":true,"description":"Code(s) INSEE de la commune. Si plusieurs codes communes, séparer les codes communes par une virgule, par exemple pour avoir les codes insee 45234 et 45100 : code_insee=45234,45100. Le nombre maximum de codes est 10. Ce type de recherche ne peut pas être combiné avec une recherche au rayon."},{"name":"code","type":"string","label":"Geography","description":null},{"name":"nom","type":"string","label":"Geography","description":null},{"name":"identifiant","type":"string","label":"CavitesModel","description":"Identifiant unique d'une cavité souterraine"},{"name":"type","type":"string","label":"CavitesModel","description":"Type de cavité souterraine"},{"name":"reperage_geo","type":"string","label":"CavitesModel","description":"Repération géographique de la cavité souterraine"},{"name":"region","type":"object","label":"CavitesModel","description":"Le code région de la cavité souterraine"},{"name":"departement","type":"object","label":"CavitesModel","description":"Le code département de la cavité souterraine"},{"name":"longitude","type":"number (float)","label":"CavitesModel","format":"float","description":"Longitude de la commune"},{"name":"latitude","type":"number (float)","label":"CavitesModel","format":"float","description":"Latitude de la commune"}],"field_count":10,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://www.georisques.gouv.fr/api/v3/api-docs/georisques-api-v1","curl":"curl -s 'https://www.georisques.gouv.fr/api/v3/api-docs/georisques-api-v1' -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-09-27T08:33:34.900Z","run_id":"d5014e00-fe95-4b99-847f-93051e6936b5","created_at":"2026-06-12T19:12:15.278Z","updated_at":"2026-09-27T08:33:34.900Z","license_raw":"etalab-2.0","license_id":"lo-2.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false,"personal_data":{"status":"named_subject_unknown","basis":"name_subject_not_stated","grain":"unknown","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":["nom"],"measures":[],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: a NAME is cited and the schema does not say whose — nom carries the row's subject in the form that identifies it, and nothing else cited says whether that subject is a person or a thing; permitted under the owner ruling of 2026-08-25 (refusing every name column withholds trees and bus stops and protects nobody) and published as unstated rather than as “no person column”; columns — identifiers: none; names: none; names of an unstated subject: nom; attributes: none; measures: none; entity keys: none"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"4002d1fef4b751df09b7f598fa05d39394a22d3b8f5c311f7ac6d7577ffb34ea","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":22,"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[] (10 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-09-27T11:43:45.390Z","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."}}