API Référentiel Collectivités Alpha

API publique sur les collectivités territoriales françaises. Données issues de Banatic (DGCL), ZLV et geo.api.gouv.fr.

Cette API est en phase alpha : les endpoints et formats de réponse peuvent évoluer. Accès libre, sans authentification requise.

Endpoints disponibles

Méthode	Endpoint	Description
`GET`	`/referentiel/v1/communes`	Rechercher des communes par nom, code postal ou code INSEE
`GET`	`/referentiel/v1/communes/:id`	Détail d'une commune (population, EPCI, départements, régions)
`GET`	`/referentiel/v1/groupements`	Rechercher des groupements (EPCI, syndicats, PETR…)
`GET`	`/referentiel/v1/groupements/:id`	Détail d'un groupement et ses communes membres
`GET`	`/referentiel/v1/groupements/competences`	Liste des 123 compétences Banatic en 14 catégories
`GET`	`/referentiel/v1/recherche`	Recherche transversale par nom (communes et groupements)

Exemples

# Rechercher une commune
curl "https://api.collectivites.beta.gouv.fr/referentiel/v1/communes?q=Paris"

# Détail d'une commune par code INSEE
curl "https://api.collectivites.beta.gouv.fr/referentiel/v1/communes/75056"

# Rechercher des groupements
curl "https://api.collectivites.beta.gouv.fr/referentiel/v1/groupements?q=Nantes"

# Liste des compétences Banatic
curl "https://api.collectivites.beta.gouv.fr/referentiel/v1/groupements/competences"

# Recherche transversale (communes + groupements)
curl "https://api.collectivites.beta.gouv.fr/referentiel/v1/recherche?q=Lyon"

Documentation Swagger complète