---
title: "Référentiels de communes et de codes postaux"
method: GET
path: "/intercommunalites/{siren}"
---

# Référentiels de communes et de codes postaux

`GET /intercommunalites/{siren}`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/intercommunalites/{siren}`
- Auth: HTTP bearer

Correspondances entre nom de commune, code INSEE, code postal, libellé d'acheminement et intercommunalité, lues dans le Code officiel géographique, la base officielle des codes postaux et le référentiel des intercommunalités : recherche d'une commune par son nom (q), communes d'un code postal (cp) ou d'une intercommunalité (siren). Chaque commune porte ses codes postaux, son intercommunalité, ses communes déléguées ou associées et ses mouvements au COG. Coût : 0 crédit par appel réussi.

## Path parameters

- `siren` string, required

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `communes` object[], required
    - `insee` string, required
    - `nom` string, nullable, required
    - `type` string, nullable, required: Type au Code officiel géographique : COM (commune), ARM (arrondissement municipal).
    - `departement` string, nullable, required
    - `codes_postaux` string[], required
    - `libelles_acheminement` string[], required
    - `epci` object, nullable, required
      - `siren` string, required
      - `nom` string, required
    - `deleguees` object[], required
      - `insee` string, required
      - `nom` string, nullable, required
      - `type` string, nullable, required
    - `mouvements` object[], required
      - `date` string, nullable, required
      - `nature` string, nullable, required: Code de la modification au COG (fusion, changement de nom, rétablissement...).
      - `avant` object, required
        - `insee` string, required
        - `nom` string, nullable, required
      - `apres` object, required
        - `insee` string, required
        - `nom` string, nullable, required
  - `confiance` 'exacte' | 'prefixe' | 'code_postal' | 'intercommunalite', required: Comment les communes ont été trouvées.
  - `intercommunalite` object, nullable, required
    - `siren` string, required
    - `nom` string, required
  - `millesimes` object, required
    - `cog` string, nullable, required
    - `codes_postaux` string, nullable, required
    - `intercommunalites` string, nullable, required
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)