{"id":"2a4a903b-c83a-4de1-9524-6ffddd0b6357","type":"API","name":"API Découpage Administratif - (API Geo)","slug":"api-decoupage-administratif-api-geo","description":"L' **API Découpage Administratif** fait partie de la boîte-à-outils API Géo. Elle permet d'interroger facilement les référentiels géographique nationaux. ### A quoi sert l'API Découpage Administratif ? En intégrant l'API dans votre système d'information, vous pouvez notamment : - rechercher une…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-decoupage-administratif-api-geo","docs_url":"https://geo.api.gouv.fr","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["geospatial","education"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/a0/16eb04d7754b989b7dcd21d77699bd-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-decoupage-administratif-api-geo","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:38.447Z","updated_at":"2026-08-21T07:28:12.816Z","last_verified_at":"2026-08-16T02:21:40.876Z","deprecated_at":null,"ranking_score":62,"last_ranked_at":"2026-08-08T15:08:35.495Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-21T07:28:12.816Z","search_vector":"'a':170B,183B 'access':82B,231B 'administr':6A,56B,90B,113B,139B 'administratif':3A,14B,40B,152A,163B,189B 'administrative':155A,205B,239B,262B,288B 'agenc':75B 'agency':224B 'an':253B 'and':245B,260B,264B,268B,276B,293B 'api':1A,4A,8A,9A,12B,23B,38B,44B,58B,63B,102B,150A,153A,157A,158A,161B,172B,187B,193B,207B,212B,251B 'applic':130B 'applications':279B 'as':242B 'authent':80B 'authentication':229B 'authentication-fre':79B 'authentication-free':228B 'boite':169B 'boite-a-outils':168B 'boundari':7A,57B,117B 'boundaries':156A,206B,266B 'boît':20B 'boîte-à-outil':19B 'build':129B 'building':278B 'by':216B,248B 'can':257B 'case':147B 'cases':296B 'code':118B 'codes':267B 'commune':98B 'communes':247B 'cover':88B 'covering':237B 'd':27B,48B,176B,197B 'dan':45B 'dans':194B 'data':74B,141B,223B,290B 'dataset':87B 'datasets':236B 'date':137B,286B 'de':17B,166B 'decoupage':151A,162B,188B 'depart':95B 'departments':244B 'develop':126B 'developers':275B 'divis':91B 'divisions':240B 'découpag':2A,13B,39B 'educ':143B,149C 'educational':292B 'ell':25B 'elle':174B 'en':41B,190B 'etalab':68B,217B 'facil':29B 'facilement':178B 'fait':15B,164B 'for':259B,274B 'free':78B,81B,227B,230B 'french':70B,89B,138B,219B,238B,287B 'geo':5A,10A,64B,154A,159A,173B,213B 'geograph':85B 'geographi':140B 'geographic':234B 'geographique':181B 'geography':289B 'geospati':145B,148C 'geospatial':294B 'govern':71B 'government':220B 'géo':24B 'géographiqu':32B 'hierarch':120B 'hierarchical':269B 'includ':142B 'including':291B 'inform':49B,105B 'information':198B,254B 'integr':100B 'integrant':191B 'integrating':249B 'intend':124B 'intended':273B 'interrog':28B 'interroger':177B 'into':252B 'intégrant':42B 'is':208B,272B 'it':225B,271B 'l':11B,37B,43B,160B,186B,192B 'la':18B,167B 'les':30B,179B 'maintain':66B 'maintained':215B 'municip':97B 'municipalities':246B 'nation':84B 'national':233B 'nationaux':33B,182B 'notam':52B 'notamment':201B 'of':210B 'organ':128B 'organizations':277B 'outil':22B 'outils':171B 'part':60B,209B 'parti':16B 'partie':165B 'permet':26B,175B 'pouvez':51B,200B 'provid':77B 'provides':226B 'public':73B,222B 'quoi':35B,184B 'recherch':53B 'rechercher':202B 'refer':86B 'reference':235B 'referentiels':180B 'region':94B 'regions':243B 'relationship':121B 'relationships':270B 'requir':132B 'require':281B 'retriev':112B 'retrieve':261B 'référentiel':31B 's':221B 'search':109B,258B 'sert':36B,185B 'standard':133B 'standardized':282B 'such':241B 'system':106B,255B 'systeme':196B 'systèm':47B 'that':280B 'the':204B,211B,218B,250B 'their':265B 'to':232B,285B 'toolkit':65B,214B 'une':54B,203B 'unit':114B 'units':263B 'up':284B 'up-to-d':134B 'up-to-date':283B 'use':146B,295B 'user':107B 'users':256B 'votr':46B 'votre':195B 'vous':50B,199B 'à':21B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"7abf1844-58f2-4b35-a86e-1e4a6b7652f7","institution_type":"AGENCY","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:38.447Z","geographic_scope":"NATIONAL","name_en":"Administrative Boundaries API - (API Geo)","description_en":"The Administrative Boundaries API is part of the API Geo toolkit maintained by Etalab, the French government's public data agency. It provides free, authentication-free access to national geographic reference datasets covering French administrative divisions such as regions, departments, and municipalities (communes). By integrating the API into an information system, users can search for and retrieve administrative units and their boundaries, codes, and hierarchical relationships. It is intended for developers and organizations building applications that require standardized, up-to-date French administrative geography data, including educational and geospatial use cases.”}, {","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":63.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://geo.api.gouv.fr","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://geo.api.gouv.fr","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://geo.api.gouv.fr/definition.yml","source":"openapi","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-decoupage-administratif-api-geo","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"2a4a903b-c83a-4de1-9524-6ffddd0b6357","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":"7abf1844-58f2-4b35-a86e-1e4a6b7652f7","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-22T20:49:39.459Z"},"api_details":{"id":"284e5ae3-213f-4064-ba19-3cbe86a634c9","entry_id":"2a4a903b-c83a-4de1-9524-6ffddd0b6357","base_url":"https://geo.api.gouv.fr","openapi_url":"https://geo.api.gouv.fr/definition.yml","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://geo.api.gouv.fr","created_at":"2026-06-07T22:08:38.467Z","updated_at":"2026-06-07T22:08:38.467Z"},"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":"53ae0035-48cd-41fb-b45a-ffb35ad3dfa8","entry_id":"2a4a903b-c83a-4de1-9524-6ffddd0b6357","status":"VERIFIED","last_checked_at":"2026-08-16T02:21:40.582Z","p50_latency_ms":1723,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:08.794Z","updated_at":"2026-08-16T02:21:40.582Z","consecutive_successes":34,"probe_url":"https://geo.api.gouv.fr","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=utf-8","probe_succeeded_at":"2026-08-16T02:21:40.582Z"},"data_profile":{"id":"8533d74d-e414-4681-a949-6fa1e63b0091","entry_id":"2a4a903b-c83a-4de1-9524-6ffddd0b6357","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"codePostal","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code postal associé","description_en":"Postal code associated with the commune."},{"name":"lat","role":"parameter","type":"number (float)","label":null,"format":"float","param_in":"query","container":"/communes","filterable":true,"description":"Latitude (en degrés)","description_en":"Latitude in degrees."},{"name":"lon","role":"parameter","type":"number (float)","label":null,"format":"float","param_in":"query","container":"/communes","filterable":true,"description":"Longitude (en degrés)","description_en":"Longitude in degrees."},{"name":"nom","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Nom de la commune","description_en":"Name of the commune."},{"name":"boost","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Mode de boost de la recherche par nom","description_en":"Boost mode used for name-based search."},{"name":"code","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/communes","filterable":true,"description":"Code de la commune","description_en":"INSEE code of the commune."},{"name":"siren","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code SIREN de la commune","description_en":"SIREN code of the commune."},{"name":"codeEpci","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code de l'EPCI associé","description_en":"Code of the associated EPCI (inter-communal grouping)."},{"name":"codeDepartement","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code du département associé","description_en":"Code of the associated department."},{"name":"codeRegion","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code de la région associée","description_en":"Code of the associated region."},{"name":"codeParent","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code de la commune si on a un arrondissement","description_en":"Code of the parent commune, for arrondissements."},{"name":"ancienCode","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Code INSEE ancien de la commune","description_en":"Former INSEE code of the commune."},{"name":"zone","role":"parameter","type":"array","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Zone permettant de filtrer à la métropole, aux DROM et aux COM. Défaut à metro,drom sauf pour les communes à metro,drom,com pour conserver le comportement historique.","description_en":"Filter to restrict results to metropolitan France, DROM or COM areas."},{"name":"type","role":"parameter","type":"array","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Type permettant de filtrer si on retourne les communes, les arrondissements ou les 2. Par défaut à commune-actuelle.","description_en":"Filter for returning communes, arrondissements, or both."},{"name":"fields","role":"parameter","type":"array","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Liste des champs souhaités dans la réponse","description_en":"List of fields requested in the response."},{"name":"format","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Format de réponse attendu","enum_values":["json","geojson"],"description_en":"Expected response format."},{"name":"geometry","role":"parameter","type":"string","label":null,"param_in":"query","container":"/communes","filterable":true,"description":"Géométrie à utiliser pour la sortie géographique","enum_values":["centre","contour","mairie","bbox"],"description_en":"Geometry type used for the geographic output."},{"name":"codesPostaux","type":"array<string>","label":"Commune","description":"Liste des codes postaux associés à la commune","description_en":"List of postal codes associated with the commune."},{"name":"epci","type":"object","label":"Commune","description":null,"description_en":"EPCI (inter-communal grouping) associated with the commune."},{"name":"departement","type":"object","label":"Commune","description":null,"description_en":"Department associated with the commune."},{"name":"region","type":"object","label":"Commune","description":null,"description_en":"Region associated with the commune."},{"name":"associees","type":"array<object>","label":"Commune","description":"Liste des codes INSEE des communes associées de la commune, si présentes","description_en":"List of INSEE codes of associated communes, if any."},{"name":"deleguees","type":"array<object>","label":"Commune","description":"Liste des codes INSEE des communes déléguées de la commune, si présentes","description_en":"List of INSEE codes of delegated communes, if any."},{"name":"population","type":"integer","label":"Commune","description":"Population municipale","description_en":"Municipal population of the commune."},{"name":"anciensCodes","type":"array<string>","label":"Commune","description":"Liste des anciens codes INSEE associés à la commune","description_en":"List of former INSEE codes associated with the commune."},{"name":"surface","type":"number (float)","label":"Commune","format":"float","description":"Surface de la commune, en hectares","description_en":"Area of the commune, in hectares."},{"name":"centre","type":"object","label":"Commune","description":"Centre de la commune (Point GeoJSON)","description_en":"Center point of the commune, as GeoJSON Point."},{"name":"contour","type":"object","label":"Commune","description":"Contour de la commune (Polygon GeoJSON)","description_en":"Boundary outline of the commune, as GeoJSON Polygon."},{"name":"mairie","type":"object","label":"Commune","description":"Mairie principale de la commune (Point GeoJSON). Pour les COM et les communes mortes pour la France, on retourne le centre.","description_en":"Location of the main town hall, as GeoJSON Point."},{"name":"bbox","type":"object","label":"Commune","description":"Rectangle englobant la commune (Polygon GeoJSON)","description_en":"Bounding box of the commune, as GeoJSON Polygon."},{"name":"financement","type":"string","label":"Epci","description":"Financement de l'EPCI, soit fiscalité additionnelle (FA), soit en fiscalité professionnelle unique (FPU)","description_en":"Funding type of the EPCI: additional taxation (FA) or unified business tax (FPU)."},{"name":"codesDepartements","type":"array<string>","label":"Epci","description":"Liste des départements de l'EPCI","description_en":"List of departments covered by the EPCI."},{"name":"codesRegions","type":"array<string>","label":"Epci","description":"Liste des régions de l'EPCI","description_en":"List of regions covered by the EPCI."},{"name":"message","type":"string","label":"Error","description":"Libellé de l'erreur","description_en":"Error label or short message."},{"name":"description","type":"string","label":"Error","description":"Explication","description_en":"Detailed explanation of the error."}],"field_count":35,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://geo.api.gouv.fr/definition.yml","curl":"curl -s 'https://geo.api.gouv.fr/definition.yml' -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-26T02:34:18.669Z","run_id":"df734240-d843-4cd3-b78c-2b5f8439635e","created_at":"2026-06-12T19:11:30.563Z","updated_at":"2026-07-26T02:34:18.669Z","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":"090286930b45bd8b1f8801f9003019d1dcff4ed086f6bd27e6107b636ee49095","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":46,"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[] (35 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T20:49:39.633Z","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."}}