{"openapi":"3.1.0","info":{"title":"API Aménagement Logement Nature (ALN)","description":"# Introduction\n\nCette API vise à ouvrir les données de la DGALN.\n\nWork In Progress...\n\n## Description de l'API\n\n
Plus d'info ici...\n\n### Principes\n\nLes liens API suivants sont disponibles depuis internet au\nformat [docs](https://api-aln.datahub.din.developpement-durable.gouv.fr/docs)\nLes réponses des API sont toutes au format JSON par défaut.\nSelon les cas, une version CSV est également disponible, le **type_export** devient une valeur obligatoire\n\n#### - Format JSON (convention du format)\n\nDans un souci de performance, l'affichage du résultat est limité en nombre de lignes selon les paramètres **page** et **\nper_page**\n\n* **page** : le numéro de page (1 par défaut)\n* **per_page** : Le nombre de ligne par page (100 par défaut, limité à 500)\n* **count** : contient le nombre total de lignes de la requête exécutée.\n* Si **count** est supérieur à (**page** x **per_page**), **next_page** et **previous_page** sont proposés pour\n faciliter la navigation de page en page. (page1, 2, 3 ... )\n\n### - Format CSV (convention du format)\n\nContrairement au format JSON, le nombre de lignes de la réponse CSV n'est pas limité. Après exécution, un fichier est\nproposé au téléchargement.\n\n### - Contenu\n\nLes réponses au format JSON sont uniformisés. Elles sont organisées selon le modèle suivant:\n\n1. Volume de la données (**count**)\n2. Pagination (**next_page** et/ou **previous_page**)\n3. Donnée metier (**data**)\n\n
\n\n## Nos sources de données\n### Référentiels ALN\n\n
Plus d'info ici...\n\nLes données sont issus du COG de l'INSEE et sont présents les référentiels suivant:\n\n- Communes [Loi Littoral](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000047911613).\n- Communes [Loi Montagne](https://www.service-public.fr/particuliers/actualites/A14389)\n- Communes soumises au [Plan d'exposition au bruit](https://www.geoportail.gouv.fr/donnees/plan-dexposition-au-bruit-peb)\n- Communes soumises au [Décret trait de côte](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000049690164): données historisées\n\n
\n\n*Historisation*\n\n- Les décrets traits de côte sont historisés, avec les dates d'application de ceux ci pour chaque commune.\n### Urbanisme\n\n
Plus d'info ici...\n\nLes données mises à disposition ici sont issues jusqu'en 2023 inclus des bases historiques SUDOCUH.\nDès 2024, les données sont récupérées via l'API de Docurba.\n\nUne migration a été effectuée en 2025 pour pouvoir réunir les données historiques de SUDOCUH\n(de 2012 à 2023 inclus) et les données issues du nouvel outil Docurba (2024 pour l’instant, 2025 à venir).\nAvec ce travail de migration, le nombre de endpoints à appeler a été réduit et remplacé par des options de\nfiltrage avancées . L’année cog n’est plus impérative pour faire une requête.\n\n| Exemple avant la migration | Exemple après la migration |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/detail/JSON?annee_cog=2022&type_collectivite=CA&competence=PLAN&page=1&per_page=100' | curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog&type_intercommunalite=CA&est_competence_plu=true' |\n| curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/liste/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=false&page=1&per_page=100&annee_cog=2022&order_by=annee_cog' |\n| curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/siren/json?annee_cog=2022&collectivite_siren=200010700&page=1&per_page=100' | curl -X 'GET' \\'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite/200010700?include_perimetre=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/nom/JSON?annee_cog=2022&collectivite_nom=Marseil&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog&search=Marseil' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/combobox/json?annee_cog=2024&competence=PLAN' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=false&page=1&per_page=100&annee_cog=2024&order_by=libelle_intercommunalite&est_competence_plu=true' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/perimetre/JSON?annee_cog=2022&collectivite_siren=200010700&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite/200010700?include_perimetre=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/collectivites/dissout/JSON?annee_cog=2024&page=1&per_page=100'| curl -X 'GET' '[https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=false&page=1&per_page=100&est_dissoute=true](https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/collectivite?include_perimetre=false&page=1&per_page=100&order_by=annee_cog&est_dissoute=true)' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/plan/communal/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/plan?page=1&per_page=100&annee_cog=2022&order_by=code_commune' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/plan/rnu/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/plan?page=1&per_page=100&annee_cog=2022&order_by=code_commune&est_rnu=true' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/plan/intercommunal/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/plan?page=1&per_page=100&order_by=annee_cog&procedures__type_document__in=PLUi%2CPLUiS' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/scot/liste/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=true&include_procedures=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog%2Cnom_scot' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/scot/approuve/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' '[https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=true&include_procedures=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog&procedures__scot_etat_simplifie=SCoT approuvé](https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=true&include_procedures=true&page=1&per_page=100&annee_cog=2022&order_by=annee_cog&procedures__scot_etat_simplifie=SCoT%20approuv%C3%A9)' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/scot/en_cours/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' '[https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=true&include_procedures=true&page=1&per_page=100&order_by=annee_cog&procedures__scot_etat_simplifie__in=SCoT en élaboration%2CSCoT en révision](https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=false&include_procedures=false&page=1&per_page=100&order_by=annee_cog&procedures__scot_etat_simplifie__in=SCoT%20en%20%C3%A9laboration%2CSCoT%20en%20r%C3%A9vision)' |\n| curl -X 'GET' 'https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/sudocuh/enquetes/ref/scot/communes/JSON?annee_cog=2022&page=1&per_page=100' | curl -X 'GET' '[https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=true&include_procedures=true&page=1&per_page=100&order_by=annee_cog](https://api-sudocuh.datahub.din.developpement-durable.gouv.fr/urbanisme/v1/scot?include_perimetre=false&include_procedures=false&page=1&per_page=100&order_by=annee_cog)' |\n\n- Afin de lister l’ensemble des données pour un choix d’années COG données:\n - pour 1 année COG en particulier, par exemple 2015, appel au endpoint urbanisme/v1/collectivite avec le filtre\n annee_cog = 2015\n - pour plusieurs années COG, par exemple 2015 et 2020 : appel au endpoint urbanisme/v1/collectivite avec le filtre\n annee_cog__in = 2015, 2020\n\n- Pour rechercher dans l’ensemble des données un mot clé\n - si on cherche à faire une recherche plein texte sur certains champs, cela peut s’effectuer en complétant le champ\n “search”. Les champs dans lesquels la recherche est effectuée sont définis au préalable dans le code. Ci-dessous\n la liste des champs selon les endpoints\n\n | endpoint | champs dans lesquels la recherche est effectuée |\n | --- | --- |\n | urbanisme/v1/collectivite | libelle_intercommunalite, nom_commune (du périmètre) |\n | urbanisme/v1/plan | cp_nom |\n | urbanisme/v1/scot | nom_scot, nom_collectivite |\n | | |\n - Exemple : pour le endpoint collectivités, chercher “Marseille” renverra la/les collectivités dont le périmètre\n englobe marseille ou dont le nom contient “Marseille”\n - Nota bene : la recherche par mot s’effectue uniquement dans le champ “search”.\n\n- A propos des périmètres et procédures par endpoint :\n - urbanisme/v1/collectivite : pour obtenir le détail du périmètre de chaque collectivité, il faut filtrer\n include_perimetre = True\n - urbanisme/v1/plan : liste l’ensemble des procédures avec leurs détails ; il n’est pas nécessaire de filtrer sur un\n booléen pour les obtenir\n - urbanisme/v1/scot : liste l’ensemble des scots par année cog ; il est nécessaire, pour avoir plus de détails sur\n les procédures, de filtrer par include_procedures = true.\n Chaque procédure a son périmètre, dont on peut obtenir les détails en ajoutant include_perimetre = true.\n\n
\n","contact":{"name":"DGALN/ICAPP/Misson Numérique","email":"andy.barakat@developpement-durable.gouv.fr"},"license":{"name":"etalab-2.0","url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf"},"version":"2.3.2"},"paths":{"/health":{"get":{"tags":["Health Check"],"summary":"Health Check endpoint","description":"Return status code if OK","operationId":"get_health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthCheck"}}}}}}},"/ref_aln/communes":{"get":{"tags":["Référentiels ALN"],"summary":"Lire les communes et les référentiels par année","description":"Liste les communes selon leur année COG, source [INSEE](https://www.insee.fr/fr/information/2560452).\n\n- **annee_cog**: Année COG\n- **est_loi_littoral**:\n Filtre les communes soumises à la [loi littoral](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000047911613).\n- **est_loi_montagne**:\n Filtre les communes soumises à la [loi montagne](https://www.service-public.fr/particuliers/actualites/A14389).\n- **est_loi_peb**:\n Filtre les communes soumises au plan d'exposition au bruit,\n [PEB](https://www.geoportail.gouv.fr/donnees/plan-dexposition-au-bruit-peb)).\n- **code_departement**: Code du département de la commune\n- **code_region**: Code de la région de la commune\n- **type_export**: Type de l'export, JSON ou CSV\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)","operationId":"read_cog_communes_ref_aln_communes_get","parameters":[{"name":"annee_cog","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/AnneeCOG"}],"title":"Annee Cog"}},{"name":"est_loi_littoral","in":"query","required":false,"schema":{"type":"boolean","title":"Est Loi Littoral"}},{"name":"est_loi_montagne","in":"query","required":false,"schema":{"type":"boolean","title":"Est Loi Montagne"}},{"name":"est_loi_peb","in":"query","required":false,"schema":{"type":"boolean","title":"Est Loi Peb"}},{"name":"code_departement","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/DepartementCode"}],"title":"Code Departement"}},{"name":"code_region","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/RegionCode"}],"title":"Code Region"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExport"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelCogCommune__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ref_aln/communes/{code_commune}":{"get":{"tags":["Référentiels ALN"],"summary":"Lire une commune et ses référentiels par année","description":"Liste les communes selon leur année COG, source [INSEE](https://www.insee.fr/fr/information/2560452).\n\n- **annee_cog**: Année COG\n- **code_commune**: Code INSEE de la commune\n- **type_export**: Type de l'export, JSON ou CSV\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)","operationId":"read_cog_commune_ref_aln_communes__code_commune__get","parameters":[{"name":"code_commune","in":"path","required":true,"schema":{"type":"string","title":"Code Commune"}},{"name":"annee_cog","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AnneeCOG"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExport"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ModelCogCommune_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ref_aln/trait_de_cote/communes":{"get":{"tags":["Référentiels ALN"],"summary":"Lire les communes trait de côte historisés","description":"Liste l'historique des communes trait de cote (toutes les communes à travers les années).\n\n- **code_departement**: Code du département de la commune\n- **code_region**: Code de la région de la commune\n- **is_active**: Si True, renvoie la liste des communes Trait de Cote à la date du jour\n- **type_export**: Type de l'export, JSON ou CSV\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)","operationId":"read_tdc_communes_ref_aln_trait_de_cote_communes_get","parameters":[{"name":"code_departement","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/DepartementCode"}],"title":"Code Departement"}},{"name":"code_region","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/RegionCode"}],"title":"Code Region"}},{"name":"is_active","in":"query","required":false,"schema":{"type":"boolean","title":"Is Active"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExport"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelTraitDeCoteCommune__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ref_aln/trait_de_cote/communes/{code_commune}":{"get":{"tags":["Référentiels ALN"],"summary":"Lire une commune trait de côte historisée par année","description":"Liste l'historique d'une commune trait de côte\n\n- **code_commune**: Code INSEE de la commune\n- **type_export**: Type de l'export, JSON ou CSV\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)","operationId":"read_tdc_commune_ref_aln_trait_de_cote_communes__code_commune__get","parameters":[{"name":"code_commune","in":"path","required":true,"schema":{"type":"string","title":"Code Commune"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExport"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelTraitDeCoteCommune__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/urbanisme/v1/collectivite":{"get":{"tags":["Urbanisme"],"summary":"Lister les collectivités et leurs périmètres","description":"Lire la liste des collectivités. Il est possible d'afficher le périmètre de chaque\ncollectivité en choisissant include_perimetre = True\n- **include_perimetre**: booléen indiquant s'il faut afficher le périmètre de l'EPCI, c'est-à-dire la\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)\n- **annee_cog**: année du Code Officiel Géographique pour laquelle on souhaite effectuer la requête\n- **siren_collectivite** : SIREN de l'EPCI\n- **order_by** : liste des noms des champs par lesquels on souhaite ordonner les résultats\n- **search**: recherche plein texte sur les champs \"libelle_intercommunalite\" et \"nom_commune\"\n- **annee_cog__in**: liste d'années COG pour lesquelles on souhaite obtenir des résultats\n- **siren_collectivite__in**: liste de siren de collectivites pour lesquels on souhaite obtenir des résultats\n- **libelle_intercommunalite**: nom de la collectivite\n- **type_intercommunalite** : type de la collectivite\n- **est_competence_plu**: booléen indiquant si la collectivité a la compétence de porter un PLU\n- **est_competence_scot**: booléen indiquant si la collectivité a la compétence de porter un SCOT\n- **collectivite_obligation_plh**: booléen indiquant si la collectivité a l'obligation d'établir un PLH\nliste des communes le composant\n- **code_departement**: code departement de la collectivite\n- **code_region**: code departement de la collectivite\n- **est_dissoute**: booléen indiquant si la collectivité est marquée comme dissoute\n- **libelle_intercommunalite__in**: liste des noms des collectivites dont on souhaute obtenir les informations\n- **perimetre__code_commune**: code commune d'une commune du périmètre d'une collectivité\n- **perimetre__nom_commune**: nom d'une commune du périmètre d'une collectivité\n- **perimetre__code_departement_commune**: code departement d'une commune du périmètre d'une collectivité\n- **perimetre__code_region_commune**: code region d'une commune du périmètre d'une collectivité","operationId":"read_collectivites_urbanisme_v1_collectivite_get","parameters":[{"name":"include_perimetre","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Perimetre"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExportBase"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}},{"name":"annee_cog","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Cog"}},{"name":"code_siren","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Siren"}},{"name":"order_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"annee_cog","title":"Order By"}},{"name":"annee_cog__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annee Cog In"}},{"name":"siren_collectivite__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siren Collectivite In"}},{"name":"type_intercommunalite","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TypeCollectivite"},{"type":"null"}],"title":"Type Intercommunalite"}},{"name":"est_competence_plu","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Competence Plu"}},{"name":"est_competence_scot","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Competence Scot"}},{"name":"collectivite_obligation_plh","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Collectivite Obligation Plh"}},{"name":"code_departement","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Departement"}},{"name":"code_region","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Region"}},{"name":"est_dissoute","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Dissoute"}},{"name":"libelle_intercommunalite","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Libelle Intercommunalite"}},{"name":"libelle_intercommunalite__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Libelle Intercommunalite In"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"perimetre__code_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Perimetre Code Commune"}},{"name":"perimetre__nom_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Perimetre Nom Commune"}},{"name":"perimetre__code_departement_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Perimetre Code Departement Commune"}},{"name":"perimetre__code_region_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Perimetre Code Region Commune"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelCollectivite__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/urbanisme/v1/collectivite/{code_siren}":{"get":{"tags":["Urbanisme"],"summary":"Lire une EPCI spécifique en fonction de son SIREN par année COG","description":"Retourne une EPCI en fonction de son SIREN, par année\n\n- **annee_cog** : Année COG\n- **siren_collectivite** : SIREN de l'EPCI\n- **include_perimetre** : booléen indiquant s'il faut afficher le périmètre de l'EPCI, c'est-à-dire la\nliste des communes le composant\n- **page**: Numéro de la page (pagination d'API)\n- **per_page** : Nombre d'enregistrements par page (pagination d'API)","operationId":"read_collectivite_urbanisme_v1_collectivite__code_siren__get","parameters":[{"name":"code_siren","in":"path","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Siren"}},{"name":"include_perimetre","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Perimetre"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExportBase"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}},{"name":"annee_cog","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Cog"}},{"name":"order_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"annee_cog","title":"Order By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ModelCollectivite_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/urbanisme/v1/plan":{"get":{"tags":["Urbanisme"],"summary":"Lister les plans d'urbanisme","description":"Liste l'ensemble des procédures d'urbanisme :\n\n- **annee_cog**\n- **code_commune**\n- **order_by** : liste des noms des champs par lesquels on souhaite ordonner les résultats\n- **search**: recherche plein texte sur le champ \"cp_nom\"\n- **annee_cog__in**: liste d'années COG pour lesquelles on souhaite obtenir des résultats\n\n- **code_departement**\n- **code_region**\n- **plan_libelle_code_etat_simplifie** : donne l'état de toutes les procédures pour la commune concernée\n- **est_rnu** : booléen indiquant si la commune est originellement soumise au RNU\n- **a_competence_plu**: booléen indiquant si la commune a la compétence PLU\n- **type_document** : indique le type du document (PLU, PLUi...) visé par la procédure\n- **type_document__in** : liste de type de documents des procédures concernées\n- **cp_siren** : siren de la collectivite porteuse\n- **cp_nom**: nom de la collectivite porteuse\n- **cp_type**: type de la collectivite porteuse\n- **type_export** : Type de l'export: JSON\n- **page** : Numéro de la page (pagination d'API)\n- **per_page** : Nombre d'enregistrements par page (pagination d'API)\n- **procedures__type_procedure**: type de la procédure parmi la liste de procédures d'une commune\n- **procedures__libelle_etat_procedure**: etat de la procédure parmi la liste de procédures d'une commune\n- **procedures__type_document**: type de document concerné par\n la procédure parmi la liste de procédures d'une commune\n- **procedures__annee_prescription**: année de prescription de la procédure parmi la liste de procédures d'une\ncommune\n- **procedures__annee_approbation**: année d'approbation de la procédure parmi la liste de procédures d'une commune\n- **procedures__source**: source des informations sur la procédure, sudocuh ou docurba","operationId":"read_plans_urbanisme_v1_plan_get","parameters":[{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExportBase"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}},{"name":"annee_cog","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Cog"}},{"name":"code_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Commune"}},{"name":"order_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"annee_cog","title":"Order By"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"annee_cog__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annee Cog In"}},{"name":"code_departement","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Departement"}},{"name":"code_region","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Region"}},{"name":"plan_libelle_code_etat_simplifie","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/PlanLibelle"},{"type":"null"}],"title":"Plan Libelle Code Etat Simplifie"}},{"name":"est_rnu","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Rnu"}},{"name":"a_competence_plu","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"A Competence Plu"}},{"name":"cp_siren","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cp Siren"}},{"name":"cp_nom","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cp Nom"}},{"name":"cp_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CpTypePlan"},{"type":"null"}],"title":"Cp Type"}},{"name":"procedures__type_procedure","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Type Procedure"}},{"name":"procedures__libelle_etat_procedure","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EtatProcedurePlan"},{"type":"null"}],"title":"Procedures Libelle Etat Procedure"}},{"name":"procedures__type_document","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TypeDocument"},{"type":"null"}],"title":"Procedures Type Document"}},{"name":"procedures__type_document__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Type Document In"}},{"name":"procedures__annee_prescription","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Annee Prescription"}},{"name":"procedures__annee_approbation","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Annee Approbation"}},{"name":"procedures__source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/UrbanismeSource"},{"type":"null"}],"title":"Procedures Source"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelPlan__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/urbanisme/v1/plan/{code_commune}":{"get":{"tags":["Urbanisme"],"summary":"Lire les procédures d'urbanisme d'une commune donnée","description":"Liste les procédures d'urbanisme pour une commune donnée\n\n- **annee_cog**: Année COG\n- **code_commune**\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)","operationId":"read_plan_urbanisme_v1_plan__code_commune__get","parameters":[{"name":"code_commune","in":"path","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Commune"}},{"name":"type_export","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/ListeFormatExportBase"}],"default":"JSON","title":"Type Export"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}},{"name":"annee_cog","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Cog"}},{"name":"order_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"annee_cog","title":"Order By"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ModelPlan_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/urbanisme/v1/scot":{"get":{"tags":["Urbanisme"],"summary":"Lister les SCOT pour une année cog donnée","description":"Donne une liste de SCOTs en fonction d'une année COG\n- **include_procedures**: booléen permettant d'afficher toutes les procédures du SCOT.\n- **include_perimetre**: booléen permettant d'afficher le périmètre de chaque procédure du SCOT.\n Il faut obligatoirement avoir fixé include_procedures=True pour afficher chaque périmètre,\n puisqu'il est lié à une procédure\n- **page**: Numéro de la page (pagination d'API)\n- **per_page**: Nombre d'enregistrements par page (pagination d'API)\n- **annee_cog**: Année COG\n- **code_siren_collectivite**: siren de la collectivite porteuse\n- **order_by** : liste des noms des champs par lesquels on souhaite ordonner les résultats\n- **annee_cog__in**: liste d'années COG pour lesquelles on souhaite obtenir des résultats\n- **nom_scot**: Nom du scot\n- **source**: source des informations (suduocuh ou docurba)\n- **code_siren_collectivite__in**: liste de sirens de collectivites dont on souhaite obtenir des informations\n- **nom_collectivite**: nom de la collectivite porteuse de scot\n- **type_collectivite** : type de la collectivite porteuse de scot\n- **search**: recherche plein texte sur les champs \"nom_scot\" et \"nom_collectivite\"\n- **procedures__est_procedure_scot_interdepartement**: booléen indiquant si la procédure est interdépartementale\n- **procedures__annee_approbation**: nnée d'approbation d'une procédure donnée\n- **procedures__scot_etat_simplifie**: état d'une procédure donnée\n- **procedures__code_commune**: code commune du périmètre d'une procédure donnée\n- **procedures__commune_code_departement**: code departement du périmètre d'une procédure donnée\n- **procedures__commune_code_region**: code region du périmètre d'une procédure donnée","operationId":"read_scots_urbanisme_v1_scot_get","parameters":[{"name":"type_export","in":"query","required":false,"schema":{"default":"JSON","title":"Type Export"}},{"name":"include_perimetre","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Perimetre"}},{"name":"include_procedures","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Procedures"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":100,"title":"Per Page"}},{"name":"annee_cog","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Cog"}},{"name":"code_siren_collectivite","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Siren Collectivite"}},{"name":"order_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"annee_cog","title":"Order By"}},{"name":"annee_cog__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Annee Cog In"}},{"name":"nom_scot","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nom Scot"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/UrbanismeSource"},{"type":"null"}],"title":"Source"}},{"name":"code_siren_collectivite__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Siren Collectivite In"}},{"name":"nom_collectivite","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nom Collectivite"}},{"name":"type_collectivite","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CpTypeScot"},{"type":"null"}],"title":"Type Collectivite"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"procedures__est_procedure_scot_interdepartement","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Procedures Est Procedure Scot Interdepartement"}},{"name":"procedures__annee_approbation","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Procedures Annee Approbation"}},{"name":"procedures__scot_etat_simplifie","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ScotEtat"},{"type":"null"}],"title":"Procedures Scot Etat Simplifie"}},{"name":"procedures__scot_etat_simplifie__in","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Scot Etat Simplifie In"}},{"name":"procedures__code_commune","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Code Commune"}},{"name":"procedures__commune_code_departement","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Commune Code Departement"}},{"name":"procedures__commune_code_region","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedures Commune Code Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_list_ModelScot__"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnneeCOG":{"type":"integer","enum":[2019,2020,2021,2022,2023,2024,2025],"title":"AnneeCOG","description":"Class that save the Annee COG available"},"CodeEtat":{"properties":{"plan_code_etat_simplifie":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Code Etat Simplifie","description":"Code état simplifié des documents durbanisme"},"plan_code_etat_complet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Code Etat Complet","description":"Code état complet des documents durbanisme"},"plan_libelle_code_etat_simplifie":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Libelle Code Etat Simplifie","description":"Libellé simplifié de l état des documents durbanisme"},"plan_libelle_code_etat_complet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Libelle Code Etat Complet","description":"Libellé complet de l état des documents durbanisme"}},"type":"object","required":["plan_code_etat_simplifie","plan_code_etat_complet","plan_libelle_code_etat_simplifie","plan_libelle_code_etat_complet"],"title":"CodeEtat","description":"Global state of a municipality's urbanistic procedures"},"Competence":{"properties":{"competence_plu":{"type":"boolean","title":"Competence Plu"},"competence_scot":{"type":"boolean","title":"Competence Scot"},"competence_plh":{"type":"boolean","title":"Competence Plh"},"obligation_plh":{"type":"boolean","title":"Obligation Plh"}},"type":"object","required":["competence_plu","competence_scot","competence_plh","obligation_plh"],"title":"Competence","description":"urbanistic competence of a collectivite"},"CpTypePlan":{"type":"string","enum":["CA","CC","CU","COM","EPT","MET","MET69","METRO","SI","SIVOM","SIVU"],"title":"CpTypePlan","description":"Type of collectivite (juridic status) for plan data"},"CpTypeScot":{"type":"string","enum":["AUTRE","CA","CC","CU","MET","METRO","PETR","PM","POLEM","SM","SMF"],"title":"CpTypeScot","description":"Type of collectivite (juridic status) for scot data"},"DepartementCode":{"type":"string","enum":["01","02","03","04","06","07","08","09","10","11","12","67","13","14","15","16","17","18","19","2A","21","22","23","79","24","25","26","91","27","28","29","30","32","33","971","973","2B","31","43","52","70","74","87","05","65","68","92","34","35","36","37","38","39","40","41","42","44","45","46","47","48","49","50","51","972","53","976","54","55","56","57","58","59","60","61","75","62","63","64","66","974","69","71","72","73","77","76","93","80","81","82","90","95","94","83","84","85","86","88","89","78","975","977","978","984","986","987","988"],"title":"DepartementCode"},"EtatProcedurePlan":{"type":"string","enum":["Approuvé","En cours","RNU sans procédure en cours"],"title":"EtatProcedurePlan","description":"Etat of urbanistic procedure"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthCheck":{"properties":{"status":{"type":"string","title":"Status","default":"OK"}},"type":"object","required":["status"],"title":"HealthCheck"},"ListeFormatExport":{"type":"string","enum":["GEOJSON","JSON","CSV","XLSX"],"title":"ListeFormatExport","description":"Class Format d'export API (permet séléction dans endpoint)) avec geojson"},"ListeFormatExportBase":{"type":"string","enum":["JSON","CSV","XLSX"],"title":"ListeFormatExportBase","description":"Class Format d'export API (permet séléction dans endpoint)) sans geojson"},"ModelCogCommune":{"properties":{"annee_cog":{"type":"integer","title":"Annee Cog","description":"Année des données (COG INSEE)"},"code_commune":{"type":"string","title":"Code Commune","description":"Code INSEE"},"nom_commune":{"type":"string","title":"Nom Commune","description":"Nom de la commune"},"nom_commune_riche":{"type":"string","title":"Nom Commune Riche","description":"Nom de la commune complet"},"code_departement":{"type":"string","title":"Code Departement","description":"Code Département"},"nom_departement":{"type":"string","title":"Nom Departement","description":"Nom du Département"},"code_region":{"type":"string","title":"Code Region","description":"Code Région"},"nom_region":{"type":"string","title":"Nom Region","description":"Nom de la région"},"est_loi_littoral":{"type":"boolean","title":"Est Loi Littoral","description":"Vrai si Commune Loi Littoral. Plus dinfo [ici](https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000047911613)"},"est_loi_montagne":{"type":"boolean","title":"Est Loi Montagne","description":"Vrai si Commune Loi Montagne. Plus dinfo [ici](https://www.service-public.fr/particuliers/actualites/A14389)"},"est_peb":{"type":"boolean","title":"Est Peb","description":"Vrai si soumis au plan dexposition au bruit (PEB). Plus dinfo [ici](https://www.geoportail.gouv.fr/donnees/plan-dexposition-au-bruit-peb)"}},"type":"object","required":["annee_cog","code_commune","nom_commune","nom_commune_riche","code_departement","nom_departement","code_region","nom_region","est_loi_littoral","est_loi_montagne","est_peb"],"title":"ModelCogCommune","description":"Cog Communes"},"ModelCollectivite":{"properties":{"annee_cog":{"type":"integer","title":"Annee Cog","description":"Année des données (COG INSEE)"},"nom_collectivite":{"type":"string","title":"Nom Collectivite","description":"Nom de la collectivité"},"siren":{"type":"string","title":"Siren","description":"SIREN de la collectivité"},"type_collectivite":{"type":"string","title":"Type Collectivite","description":"Type de collectivité"},"competence":{"allOf":[{"$ref":"#/components/schemas/Competence"}],"description":"Compétence en urbanisme de la collectivité","default":""},"population":{"type":"integer","title":"Population","description":"Population totale de la collectivité","default":0},"groupement_interdepartemental":{"type":"boolean","title":"Groupement Interdepartemental","description":"Indique si la collectivité est interdépartementale"},"nombre_membres":{"type":"integer","title":"Nombre Membres","description":"Nombre de membres de la collectivité"},"perimetre":{"anyOf":[{"items":{"$ref":"#/components/schemas/Perimetre"},"type":"array"},{"type":"null"}],"title":"Perimetre","description":"Perimetre de l'epci"},"est_dissoute":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Dissoute","description":"Booléen indiquant si la collectivité est dissoute"}},"type":"object","required":["annee_cog","nom_collectivite","siren","type_collectivite","competence","population","groupement_interdepartemental","nombre_membres","perimetre","est_dissoute"],"title":"ModelCollectivite","description":"Collectivité attributes by annee COG"},"ModelDecretHistorique":{"properties":{"numero_decret":{"type":"string","title":"Numero Decret","description":"Numéro du décret"},"url_decret":{"type":"string","title":"Url Decret","description":"Lien vers le décret sur legifrance.gouv.fr"},"start_date":{"type":"string","format":"date","title":"Start Date","description":"Date de début de validité du décret"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date","description":"Date de fin de validité du décret"},"is_active":{"type":"boolean","title":"Is Active","description":"Vrai si la commune est dans la liste du Décret concernée."}},"type":"object","required":["numero_decret","url_decret","start_date","end_date","is_active"],"title":"ModelDecretHistorique","description":"Modèle générique pour l'historique des décrets"},"ModelPlan":{"properties":{"annee_cog":{"type":"integer","title":"Annee Cog","description":"Année des données (COG INSEE)"},"commune":{"allOf":[{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__plan__Commune"}],"description":"Commune concernée par le plan durbanisme"},"code_etat":{"anyOf":[{"$ref":"#/components/schemas/CodeEtat"},{"type":"null"}],"description":"Etat des procédures pour la commune"},"collectivite_porteuse":{"anyOf":[{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__plan__Collectivite"},{"type":"null"}],"description":"Collectivité porteuse si la commune na pas la compétence"},"procedures":{"anyOf":[{"items":{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__plan__Procedure"},"type":"array"},{"type":"null"}],"title":"Procedures","description":"Procédure durbanisme et statut"}},"type":"object","required":["annee_cog","commune","code_etat","collectivite_porteuse","procedures"],"title":"ModelPlan","description":"A municipality's urbanistic documents"},"ModelScot":{"properties":{"annee_cog":{"type":"integer","title":"Annee Cog","description":"Année COG du Scot"},"nom":{"type":"string","title":"Nom","description":"nom du scot"},"etat_simplifie":{"type":"string","title":"Etat Simplifie","description":"Etat du scot"},"source":{"type":"string","title":"Source","description":"Source des données décrivant le Scot"},"nb_procedures_par_scot":{"type":"integer","title":"Nb Procedures Par Scot","description":"Nombre de procédures pour un scot"},"collectivite":{"allOf":[{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__scot__Collectivite"}],"description":"Collectivité concernée par le scot"},"procedures":{"anyOf":[{"items":{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__scot__Procedure"},"type":"array"},{"type":"null"}],"title":"Procedures","description":"Procédures acceptées ou en cours pour le SCOT"}},"type":"object","required":["annee_cog","nom","etat_simplifie","source","nb_procedures_par_scot","collectivite","procedures"],"title":"ModelScot","description":"Plan par année COG"},"ModelTraitDeCoteCommune":{"properties":{"code_commune":{"type":"string","title":"Code Commune","description":"Code INSEE"},"nom_commune":{"type":"string","title":"Nom Commune","description":"Nom de la commune"},"code_departement":{"type":"string","title":"Code Departement","description":"Code Département"},"nom_departement":{"type":"string","title":"Nom Departement","description":"Nom du Département"},"code_region":{"type":"string","title":"Code Region","description":"Code Région"},"nom_region":{"type":"string","title":"Nom Region","description":"Nom de la région"},"is_currently_active":{"type":"boolean","title":"Is Currently Active","description":"Vrai si la commune est dans la liste actualisée du Décret à la date du jour de la requête."},"trait_de_cote_historique":{"items":{"$ref":"#/components/schemas/ModelDecretHistorique"},"type":"array","title":"Trait De Cote Historique","description":"Historique des décrets concernés pour la commune et le référentiel."}},"type":"object","required":["code_commune","nom_commune","code_departement","nom_departement","code_region","nom_region","is_currently_active","trait_de_cote_historique"],"title":"ModelTraitDeCoteCommune","description":"Modèle pour les communes trait de cote"},"PaginatedResponse_ModelCogCommune_":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"$ref":"#/components/schemas/ModelCogCommune"},{"items":{"$ref":"#/components/schemas/ModelCogCommune"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[ModelCogCommune]"},"PaginatedResponse_ModelCollectivite_":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"$ref":"#/components/schemas/ModelCollectivite"},{"items":{"$ref":"#/components/schemas/ModelCollectivite"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[ModelCollectivite]"},"PaginatedResponse_ModelPlan_":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"$ref":"#/components/schemas/ModelPlan"},{"items":{"$ref":"#/components/schemas/ModelPlan"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[ModelPlan]"},"PaginatedResponse_list_ModelCogCommune__":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelCogCommune"},"type":"array"},{"items":{"items":{"$ref":"#/components/schemas/ModelCogCommune"},"type":"array"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[list[ModelCogCommune]]"},"PaginatedResponse_list_ModelCollectivite__":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelCollectivite"},"type":"array"},{"items":{"items":{"$ref":"#/components/schemas/ModelCollectivite"},"type":"array"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[list[ModelCollectivite]]"},"PaginatedResponse_list_ModelPlan__":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelPlan"},"type":"array"},{"items":{"items":{"$ref":"#/components/schemas/ModelPlan"},"type":"array"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[list[ModelPlan]]"},"PaginatedResponse_list_ModelScot__":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelScot"},"type":"array"},{"items":{"items":{"$ref":"#/components/schemas/ModelScot"},"type":"array"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[list[ModelScot]]"},"PaginatedResponse_list_ModelTraitDeCoteCommune__":{"properties":{"count":{"type":"integer","title":"Count","description":"Nombre d'enregistrements"},"next_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Next Page","description":"URL de la page suivante, si elle existe"},"previous_page":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Previous Page","description":"URL de la page précédente, si elle existe"},"data":{"anyOf":[{"items":{"$ref":"#/components/schemas/ModelTraitDeCoteCommune"},"type":"array"},{"items":{"items":{"$ref":"#/components/schemas/ModelTraitDeCoteCommune"},"type":"array"},"type":"array"}],"title":"Data","description":"Données en retour dAPI."}},"type":"object","required":["count","next_page","previous_page","data"],"title":"PaginatedResponse[list[ModelTraitDeCoteCommune]]"},"Perimetre":{"properties":{"code_commune":{"type":"string","title":"Code Commune"},"nom_commune":{"type":"string","title":"Nom Commune"},"code_departement_commune":{"type":"string","title":"Code Departement Commune"},"code_region_commune":{"type":"string","title":"Code Region Commune"},"commune_pop_totale":{"type":"number","title":"Commune Pop Totale"},"commune_superficie":{"type":"number","title":"Commune Superficie"}},"type":"object","required":["code_commune","nom_commune","code_departement_commune","code_region_commune","commune_pop_totale","commune_superficie"],"title":"Perimetre","description":"commune that is member of a collectivite"},"PlanLibelle":{"type":"string","enum":["CC en élaboration","CC en révision","PLU approuvé","PLU approuvé - CC en élaboration","PLU en élaboration","PLU en révision","PLU ou PLUi approuvé","PLU ou PLUi approuvé - CC en élaboration","PLU ou PLUi approuvé - en révision","POS approuvé","POS approuvé - CC en élaboration","POS approuvé - PLU en révision","POS approuvé - PLU ou PLUi en cours","RNU","RNU - CC en élaboration","RNU - PLU ou PLUi en élaboration"],"title":"PlanLibelle"},"RegionCode":{"type":"string","enum":["84","27","53","24","94","44","01","03","32","11","02","06","28","75","76","52","93","04"],"title":"RegionCode"},"ScotEtat":{"type":"string","enum":["SCoT approuvé","SCoT en élaboration","SCoT en révision"],"title":"ScotEtat"},"TypeCollectivite":{"type":"string","enum":["SM","CA","CC","CU","EPT","MET","PETR","PM","SAN","SI","AUTRE"],"title":"TypeCollectivite","description":"Type of collectivite (juridic status)"},"TypeDocument":{"type":"string","enum":["Aucun","CC","CCi","PLU","PLUi","PLUiS","PLUiHM","POS","RNU"],"title":"TypeDocument"},"UrbanismeSource":{"type":"string","enum":["DOCURBA","SUDOCUH"],"title":"UrbanismeSource"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"api__src__schemas__urbanisme__v1__plan__Collectivite":{"properties":{"nom":{"type":"string","title":"Nom","description":"Nom de la collectivité"},"siren":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siren","description":"Siret de la collectivité"},"type":{"type":"string","title":"Type","description":"Type dEPCI"},"est_competence_plu":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Competence Plu","description":"Indique si la collectivité porteuse a la compétence PLU"},"est_competence_scot":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Est Competence Scot","description":"Indique si la collectivité porteuse a la compétence SCOT"}},"type":"object","required":["nom","siren","type","est_competence_plu","est_competence_scot"],"title":"Collectivite","description":"Collectivity and its competences"},"api__src__schemas__urbanisme__v1__plan__Commune":{"properties":{"code_commune":{"type":"string","title":"Code Commune","description":"Code commune"},"nom_commune":{"type":"string","title":"Nom Commune","description":"Nom commune"},"last_population":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Population","description":"Dernière donnée de population pour la commune"},"last_superficie":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Superficie","description":"Dernière donnée de superficie pour la commune"},"code_departement":{"type":"string","title":"Code Departement","description":"code departement de la commune"},"code_region":{"type":"string","title":"Code Region","description":"Nom de la région de la commune"},"nom_region":{"type":"string","title":"Nom Region","description":"Nom de la région de la commune"},"a_competence_plu":{"type":"boolean","title":"A Competence Plu","description":"La commune a la compétence de rédiger un PLU"},"est_rnu":{"type":"boolean","title":"Est Rnu","description":"Booléen indiquant si la commune est au RNU"}},"type":"object","required":["code_commune","nom_commune","last_population","last_superficie","code_departement","code_region","nom_region","a_competence_plu","est_rnu"],"title":"Commune","description":"A municipality's demography and urbanistic competences"},"api__src__schemas__urbanisme__v1__plan__Procedure":{"properties":{"procedure_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Procedure Id","description":"Identifiant de la procédure sur sudocuh ou docurba"},"statut":{"type":"string","title":"Statut","description":"Statut de la procédure : Approuvé, En Cours"},"type_procedure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Procedure","description":"Type de la procédure"},"type_document":{"type":"string","title":"Type Document","description":"Type de document"},"sectoriel":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sectoriel","description":"Booléen indiquant si le plan est sectoriel"},"date_prescription":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Prescription","description":"Date ISO de la prescription en cours"},"annee_prescription":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Prescription"},"date_arret_projet":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Arret Projet","description":"Date ISO de l'arrêt de projet en cours"},"date_pac":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Pac","description":"Date ISO du PAC opposable"},"date_pac_comp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Pac Comp","description":"Date ISO de la complétion du PAC opposable"},"date_approbation":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Approbation"},"annee_approbation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Approbation"},"delai_approbation":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delai Approbation"},"date_executoire":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Executoire"},"plui_valant_scot":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Plui Valant Scot"},"pluih":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pluih"},"pdu_tient_lieu":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pdu Tient Lieu"},"pdu_obligatoire":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pdu Obligatoire"},"nom_sst":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nom Sst"},"cout_sst_ht":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cout Sst Ht"},"cout_sst_ttc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cout Sst Ttc"},"source":{"type":"string","title":"Source"}},"type":"object","required":["procedure_id","statut","type_procedure","type_document","sectoriel","date_prescription","annee_prescription","date_arret_projet","date_pac","date_pac_comp","date_approbation","annee_approbation","delai_approbation","date_executoire","plui_valant_scot","pluih","pdu_tient_lieu","pdu_obligatoire","nom_sst","cout_sst_ht","cout_sst_ttc","source"],"title":"Procedure","description":"Urbanistic procedure"},"api__src__schemas__urbanisme__v1__scot__Collectivite":{"properties":{"nom":{"type":"string","title":"Nom","description":"Nom de la collectivité"},"siren":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siren","description":"Siren de la collectivité"},"type":{"type":"string","title":"Type","description":"Type dEPCI"}},"type":"object","required":["nom","siren","type"],"title":"Collectivite"},"api__src__schemas__urbanisme__v1__scot__Commune":{"properties":{"code_commune":{"type":"string","title":"Code Commune","description":"Code commune"},"code_departement":{"type":"string","title":"Code Departement","description":"Code département de la commune"},"code_region":{"type":"string","title":"Code Region","description":"Code région de la commune"},"commune_population_totale":{"type":"number","title":"Commune Population Totale","description":"Population totale de la commune"},"commune_superficie":{"type":"number","title":"Commune Superficie","description":"Superficie de la commune"}},"type":"object","required":["code_commune","code_departement","code_region","commune_population_totale","commune_superficie"],"title":"Commune"},"api__src__schemas__urbanisme__v1__scot__Procedure":{"properties":{"procedure_id":{"type":"string","title":"Procedure Id","description":"Id de la procédure"},"est_procedure_scot_interdepartement":{"type":"boolean","title":"Est Procedure Scot Interdepartement","description":"Booléen indiquant si la procédure concerne un scot interdépartement"},"date_publication_perimetre":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Publication Perimetre","description":"Date de publication du périmètre"},"date_prescription":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Prescription","description":"Date de prescription de la procédure"},"date_arret_projet":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Arret Projet","description":"Date d'arrêt du projet"},"date_approbation":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Approbation","description":"Date d'approbation de la procédure"},"annee_approbation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Annee Approbation","description":"Année d'approbation de la procédure"},"date_fin_echeance":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Fin Echeance","description":"Date de fin d'échéance"},"nb_communes":{"type":"integer","title":"Nb Communes","description":"Nombre de communes concernées"},"libelle_etat_procedure":{"type":"string","title":"Libelle Etat Procedure","description":"Etat de la procédure"},"perimetre":{"anyOf":[{"items":{"$ref":"#/components/schemas/api__src__schemas__urbanisme__v1__scot__Commune"},"type":"array"},{"type":"null"}],"title":"Perimetre","description":"Ensemble des communes concernées par la procédure"}},"type":"object","required":["procedure_id","est_procedure_scot_interdepartement","date_publication_perimetre","date_prescription","date_arret_projet","date_approbation","annee_approbation","date_fin_echeance","nb_communes","libelle_etat_procedure","perimetre"],"title":"Procedure"}}},"tags":[{"name":"Référentiels ALN","description":"Inventaire des référentiels de la DGALN par année COG"},{"name":"Urbanisme","description":"Inventaire du chargement des données PLan, SCoT et collectivités par année depuis 2012.Contient les données issues de sudocuh jusqu'en 2023 inclus, et à partir de 2024, les données issues de Docurba"}]}