Administrative Boundaries API - (API Geo)API Découpage Administratif - (API Geo)
API Découpage Administratif - (API Geo)Administrative Boundaries API - (API Geo)
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.”}, {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…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (35 fields)
| Field | Type | Description |
|---|---|---|
| codePostalCode postal | string | Postal code associated with the commune.Code postal associé |
| lat | number (float) | Latitude in degrees.Latitude (en degrés) |
| lon | number (float) | Longitude in degrees.Longitude (en degrés) |
| nom | string | Name of the commune.Nom de la commune |
| boost | string | Boost mode used for name-based search.Mode de boost de la recherche par nom |
| code | string | INSEE code of the commune.Code de la commune |
| sirenSIREN (company) | string | SIREN code of the commune.Code SIREN de la commune |
| codeEpciCode epci | string | Code of the associated EPCI (inter-communal grouping).Code de l'EPCI associé |
| codeDepartementCode departement | string | Code of the associated department.Code du département associé |
| codeRegionCode region | string | Code of the associated region.Code de la région associée |
| codeParentCode parent | string | Code of the parent commune, for arrondissements.Code de la commune si on a un arrondissement |
| ancienCodeAncien code | string | Former INSEE code of the commune.Code INSEE ancien de la commune |
| zone | array | Filter to restrict results to metropolitan France, DROM or COM areas.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. |
| type | array | Filter for returning communes, arrondissements, or both.Type permettant de filtrer si on retourne les communes, les arrondissements ou les 2. Par défaut à commune-actuelle. |
| fields | array | List of fields requested in the response.Liste des champs souhaités dans la réponse |
| format | string | Expected response format.Format de réponse attendu |
| geometryGeometry | string | Geometry type used for the geographic output.Géométrie à utiliser pour la sortie géographique |
| codesPostauxCommune | array<string> | List of postal codes associated with the commune.Liste des codes postaux associés à la commune |
| epciCommune | object | EPCI (inter-communal grouping) associated with the commune.EPCI (inter-communal grouping) associated with the commune. |
| departementCommune | object | Department associated with the commune.Department associated with the commune. |
| regionCommune | object | Region associated with the commune.Region associated with the commune. |
| associeesCommune | array<object> | List of INSEE codes of associated communes, if any.Liste des codes INSEE des communes associées de la commune, si présentes |
| delegueesCommune | array<object> | List of INSEE codes of delegated communes, if any.Liste des codes INSEE des communes déléguées de la commune, si présentes |
| populationCommune | integer | Municipal population of the commune.Population municipale |
| anciensCodesCommune | array<string> | List of former INSEE codes associated with the commune.Liste des anciens codes INSEE associés à la commune |
| surfaceCommune | number (float) | Area of the commune, in hectares.Surface de la commune, en hectares |
| centreCommune | object | Center point of the commune, as GeoJSON Point.Centre de la commune (Point GeoJSON) |
| contourCommune | object | Boundary outline of the commune, as GeoJSON Polygon.Contour de la commune (Polygon GeoJSON) |
| mairieCommune | object | Location of the main town hall, as GeoJSON Point.Mairie principale de la commune (Point GeoJSON). Pour les COM et les communes mortes pour la France, on retourne le centre. |
| bboxCommune | object | Bounding box of the commune, as GeoJSON Polygon.Rectangle englobant la commune (Polygon GeoJSON) |
| financementEpci | string | Funding type of the EPCI: additional taxation (FA) or unified business tax (FPU).Financement de l'EPCI, soit fiscalité additionnelle (FA), soit en fiscalité professionnelle unique (FPU) |
| codesDepartementsEpci | array<string> | List of departments covered by the EPCI.Liste des départements de l'EPCI |
| codesRegionsEpci | array<string> | List of regions covered by the EPCI.Liste des régions de l'EPCI |
| messageError | string | Error label or short message.Libellé de l'erreur |
| descriptionError | string | Detailed explanation of the error.Explication |
Schema captured from openapi 28 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://geo.api.gouv.fr
- Format
- openapi
Query examples
curl -s 'https://geo.api.gouv.fr/definition.yml' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.