Urban Planning API - Urban planning survey resultsAPI Urbanisme - Résultats des enquêtes d'urbanisme
API Urbanisme - Résultats des enquêtes d'urbanismeUrban Planning API - Urban planning survey results
This French national API provides access to the historical records of urban planning document planning since 2013. It covers territorial coherence schemes (SCoT) and national planning of urban planning documents such as local urban plans (PLU), intercommunal local urban plans (PLUi), and communal maps (CC), among other related documents. Published by the French Government, it allows retrieval of the evolution of planning instruments across French territory over time, supporting analysis of land-use and urban development regulation at the national level.Cette API vous permet d'accéder à l'historique des données concernant la planification nationale des documents d'urbanisme depuis 2013. Vous y retrouverez les données suivantes : * Schéma de cohérence territoriale (SCoT) ; * Planification nationale des documents d'urbanisme (PLU, CC, PLUi, CC, R…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (92 fields)
| Field | Type | Description |
|---|---|---|
| annee_cogAnnee cog | string | Year of the official geographic code (COG) reference.Year of the official geographic code (COG) reference. |
| est_loi_littoralEst loi littoral | boolean | Whether the area is subject to the coastal protection law (Loi Littoral).Whether the area is subject to the coastal protection law (Loi Littoral). |
| est_loi_montagneEst loi montagne | boolean | Whether the area is subject to the mountain protection law (Loi Montagne).Whether the area is subject to the mountain protection law (Loi Montagne). |
| est_loi_pebEst loi peb | boolean | Whether the area is subject to noise exposure plan regulations.Whether the area is subject to noise exposure plan regulations. |
| code_departementDépartement code | string | Department code filter.Department code filter. |
| code_regionRégion code | string | Region code filter.Region code filter. |
| type_exportType export | string | Requested export format type.Requested export format type. |
| page | integer | Page number for paginated results.Page number for paginated results. |
| per_pagePer page | integer | Number of records returned per page.Number of records returned per page. |
| code_communeCommune code | string | Municipality (commune) code filter.Municipality (commune) code filter. |
| is_activeIs active | boolean | Whether the record is currently active.Whether the record is currently active. |
| include_perimetreInclude perimetre | boolean | Whether to include the boundary/perimeter data in the response.Whether to include the boundary/perimeter data in the response. |
| code_sirenCode siren | string | SIREN identifier filter for the entity.SIREN identifier filter for the entity. |
| order_byOrder by | string | Field name used to sort the results.Field name used to sort the results. |
| annee_cog__inAnnee cog in | string | Filter by a list of COG reference years.Filter by a list of COG reference years. |
| siren_collectivite__inSiren collectivite in | string | Filter by a list of local authority SIREN numbers.Filter by a list of local authority SIREN numbers. |
| type_intercommunaliteType intercommunalite | string | Type of intercommunal grouping.Type of intercommunal grouping. |
| est_competence_pluEst competence plu | string | Filter for whether the authority holds local plan (PLU) competence.Filter for whether the authority holds local plan (PLU) competence. |
| est_competence_scotEst competence scot | string | Filter for whether the authority holds SCoT competence.Filter for whether the authority holds SCoT competence. |
| collectivite_obligation_plhCollectivite obligation plh | string | Filter for whether the authority is required to have a local housing plan (PLH).Filter for whether the authority is required to have a local housing plan (PLH). |
| est_dissouteEst dissoute | string | Filter for whether the authority has been dissolved.Filter for whether the authority has been dissolved. |
| libelle_intercommunaliteLibelle intercommunalite | string | Name of the intercommunal grouping.Name of the intercommunal grouping. |
| libelle_intercommunalite__inLibelle intercommunalite in | string | Filter by a list of intercommunal grouping names.Filter by a list of intercommunal grouping names. |
| search | string | Free-text search query.Free-text search query. |
| perimetre__code_communePerimetre code commune | string | Filter by municipality code within the perimeter.Filter by municipality code within the perimeter. |
| perimetre__nom_communePerimetre nom commune | string | Filter by municipality name within the perimeter.Filter by municipality name within the perimeter. |
| perimetre__code_departement_communePerimetre code departement commune | string | Filter by department code of communes in the perimeter.Filter by department code of communes in the perimeter. |
| perimetre__code_region_communePerimetre code region commune | string | Filter by region code of communes in the perimeter.Filter by region code of communes in the perimeter. |
| plan_libelle_code_etat_simplifiePlan libelle code etat simplifie | string | Simplified status label of the urban planning document.Simplified status label of the urban planning document. |
| est_rnuEst rnu | string | Filter for whether the national planning regulations (RNU) apply.Filter for whether the national planning regulations (RNU) apply. |
| a_competence_pluA competence plu | string | Filter for whether the entity holds local plan (PLU) competence.Filter for whether the entity holds local plan (PLU) competence. |
| cp_sirenCp siren | string | SIREN identifier of the authority holding competence.SIREN identifier of the authority holding competence. |
| cp_nomCp nom | string | Name of the authority holding competence.Name of the authority holding competence. |
| cp_typeCp type | string | Type of the authority holding competence.Type of the authority holding competence. |
| procedures__type_procedureProcedures type procedure | string | Filter by type of planning procedure.Filter by type of planning procedure. |
| procedures__libelle_etat_procedureProcedures libelle etat procedure | string | Filter by status label of the procedure.Filter by status label of the procedure. |
| procedures__type_documentProcedures type document | string | Filter by type of planning document.Filter by type of planning document. |
| procedures__type_document__inProcedures type document in | string | Filter by a list of planning document types.Filter by a list of planning document types. |
| procedures__annee_prescriptionProcedures annee prescription | string | Filter by year the procedure was prescribed.Filter by year the procedure was prescribed. |
| procedures__annee_approbationProcedures annee approbation | string | Filter by year the procedure was approved.Filter by year the procedure was approved. |
| procedures__sourceProcedures source | string | Filter by data source of the procedure.Filter by data source of the procedure. |
| include_proceduresInclude procedures | boolean | Whether to include related procedures in the response.Whether to include related procedures in the response. |
| code_siren_collectiviteCode siren collectivite | string | SIREN code of the local authority.SIREN code of the local authority. |
| nom_scotNom scot | string | Name of the SCoT (territorial coherence plan).Name of the SCoT (territorial coherence plan). |
| source | string | Data source of the record.Data source of the record. |
| code_siren_collectivite__inCode siren collectivite in | string | Filter by a list of local authority SIREN codes.Filter by a list of local authority SIREN codes. |
| nom_collectiviteNom collectivite | string | Name of the local authority.Name of the local authority. |
| type_collectiviteType collectivite | string | Type of local authority.Type of local authority. |
| procedures__est_procedure_scot_interdepartementProcedures est procedure scot interdepartement | string | Filter for whether the SCoT procedure spans multiple departments.Filter for whether the SCoT procedure spans multiple departments. |
| procedures__scot_etat_simplifieProcedures scot etat simplifie | string | Filter by simplified status of the SCoT.Filter by simplified status of the SCoT. |
| procedures__scot_etat_simplifie__inProcedures scot etat simplifie in | string | Filter by a list of simplified SCoT statuses.Filter by a list of simplified SCoT statuses. |
| procedures__code_communeProcedures code commune | string | Filter by municipality code of the procedure.Filter by municipality code of the procedure. |
| procedures__commune_code_departementProcedures commune code departement | string | Filter by department code of the procedure's municipality.Filter by department code of the procedure's municipality. |
| procedures__commune_code_regionProcedures commune code region | string | Filter by region code of the procedure's municipality.Filter by region code of the procedure's municipality. |
| plan_code_etat_simplifieCodeEtat | unknown | Simplified status code of the urban planning document.Code état simplifié des documents durbanisme |
| plan_code_etat_completCodeEtat | unknown | Full status code of the urban planning document.Code état complet des documents durbanisme |
| plan_libelle_code_etat_completCodeEtat | unknown | Full status label of the urban planning document.Libellé complet de l état des documents durbanisme |
| competence_pluCompetence | boolean | Whether the authority holds local plan (PLU) competence.Whether the authority holds local plan (PLU) competence. |
| competence_scotCompetence | boolean | Whether the authority holds SCoT competence.Whether the authority holds SCoT competence. |
| competence_plhCompetence | boolean | Whether the authority holds local housing plan (PLH) competence.Whether the authority holds local housing plan (PLH) competence. |
| obligation_plhCompetence | boolean | Whether the authority is legally required to adopt a local housing plan.Whether the authority is legally required to adopt a local housing plan. |
| detailHTTPValidationError | array<object> | List of validation error details.List of validation error details. |
| statusHealthCheck | string | Health check status of the API.Health check status of the API. |
| nom_communeModelCogCommune | string | Name of the municipality.Nom de la commune |
| nom_commune_richeModelCogCommune | string | Full extended name of the municipality.Nom de la commune complet |
| nom_departementModelCogCommune | string | Name of the department.Nom du Département |
| nom_regionModelCogCommune | string | Name of the region.Nom de la région |
| est_pebModelCogCommune | boolean | Whether the municipality is subject to a noise exposure plan (PEB).Vrai si soumis au plan dexposition au bruit (PEB). Plus dinfo [ici](https://www.geoportail.gouv.fr/donnees/plan-dexposition-au-bruit-peb) |
| sirenModelCollectivite | string | SIREN identifier of the local authority.SIREN de la collectivité |
| competenceModelCollectivite | unknown | Urban planning competence held by the authority.Compétence en urbanisme de la collectivité |
| populationModelCollectivite | integer | Total population of the local authority.Population totale de la collectivité |
| groupement_interdepartementalModelCollectivite | boolean | Whether the authority spans multiple departments.Indique si la collectivité est interdépartementale |
| nombre_membresModelCollectivite | integer | Number of member municipalities in the authority.Nombre de membres de la collectivité |
| perimetreModelCollectivite | unknown | Perimeter boundary of the intercommunal authority.Perimetre de l'epci |
| numero_decretModelDecretHistorique | string | Reference number of the decree.Numéro du décret |
| url_decretModelDecretHistorique | string | Link to the decree on legifrance.gouv.fr.Lien vers le décret sur legifrance.gouv.fr |
| start_dateModelDecretHistorique | string (date) | Date the decree took effect.Date de début de validité du décret |
| end_dateModelDecretHistorique | unknown | Date the decree ceased to be valid.Date de fin de validité du décret |
| communeModelPlan | unknown | Municipality concerned by the urban planning document.Commune concernée par le plan durbanisme |
| code_etatModelPlan | unknown | Status of the planning procedures for the municipality.Etat des procédures pour la commune |
| collectivite_porteuseModelPlan | unknown | Authority responsible for the plan if the municipality lacks competence.Collectivité porteuse si la commune na pas la compétence |
| proceduresModelPlan | unknown | Urban planning procedure and its status.Procédure durbanisme et statut |
| nomModelScot | string | Name of the SCoT.nom du scot |
| etat_simplifieModelScot | string | Simplified status of the SCoT.Etat du scot |
| nb_procedures_par_scotModelScot | integer | Number of procedures associated with the SCoT.Nombre de procédures pour un scot |
| collectiviteModelScot | unknown | Local authority concerned by the SCoT.Collectivité concernée par le scot |
| is_currently_activeModelTraitDeCoteCommune | boolean | Whether the municipality is currently listed in the updated decree.Vrai si la commune est dans la liste actualisée du Décret à la date du jour de la requête. |
| trait_de_cote_historiqueModelTraitDeCoteCommune | array<object> | History of coastal erosion decrees applying to the municipality.Historique des décrets concernés pour la commune et le référentiel. |
| countPaginatedResponse_ModelCogCommune_ | integer | Total number of records available.Nombre d'enregistrements |
| next_pagePaginatedResponse_ModelCogCommune_ | unknown | URL of the next results page, if available.URL de la page suivante, si elle existe |
| previous_pagePaginatedResponse_ModelCogCommune_ | unknown | URL of the previous results page, if available.URL de la page précédente, si elle existe |
| dataPaginatedResponse_ModelCogCommune_ | unknown | List of data records returned by the API.Données en retour dAPI. |
Schema captured from openapi 1 month ago.
Verification Status
Using the API
Configuration
- Format
- openapi
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://api-aln.datahub.din.developpement-durable.gouv.fr/openapi.json' -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.