---
title: "Sociétés civiles domiciliées à une adresse"
method: GET
path: "/adresses/{cle_ban}/societes-civiles"
---

# Sociétés civiles domiciliées à une adresse

`GET /adresses/{cle_ban}/societes-civiles`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/adresses/{cle_ban}/societes-civiles`
- Auth: HTTP bearer

Les sociétés civiles (immobilières, de moyens...) domiciliées à une adresse de la Base Adresse Nationale, par sa clé : dénomination, SIREN, forme, avis BODACC (création, modification, radiation, procédure, cession) avec leur date, et présence d'une société avant le dernier DPE. Les avis sont ceux que la gold de Pillr rattache à l'adresse ; le SIREN est rapproché par la dénomination et le code postal. Les gérants et associés ne sont jamais nommés. Adresse inconnue : 404 adresse_introuvable, rien n'est débité ; une adresse sans société civile rend n = 0. Coût : 3 crédits par appel réussi.

## Path parameters

- `cle_ban` string, required: Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

## Response `200`

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

- object
  - `cle_ban` string, required
  - `insee` string, nullable, required
  - `code_postal` string, nullable, required
  - `n` integer, required: Sociétés civiles domiciliées à l'adresse.
  - `n_avis` integer, required
  - `societes` object[], required
    - `denomination` string, nullable, required
    - `siren` string, nullable, required: SIREN rapproché par la dénomination et le code postal dans le BODACC ; null s'il n'a pas été trouvé.
    - `siren_rapprochement` 'denomination_code_postal', nullable, required: Comment le SIREN a été trouvé : par la dénomination et le code postal de l'adresse (pas par le registre de l'avis).
    - `forme` string, nullable, required: Forme juridique (société civile immobilière, de moyens...).
    - `avis` object[], required: Avis BODACC de la société domiciliée à l'adresse, le plus récent d'abord.
      - `date` string, required: Date de l'avis (AAAA-MM-JJ).
      - `famille` 'creation' | 'immatriculation' | 'modification' | 'radiation' | 'collective' | 'conciliation' | 'retablissement_professionnel' | 'vente' | 'dpc' | 'autre', required: Famille de l'avis (codes du BODACC ; autre pour un libellé inconnu).
      - `type` string, nullable, required: Libellé de l'avis tel que publié (Créations, Modifications diverses, Radiations...).
    - `creation_le` string, nullable, required
    - `radiation_le` string, nullable, required
    - `procedure_le` string, nullable, required
    - `cession_le` string, nullable, required
    - `dernier_avis_le` string, nullable, required
  - `derniere_denomination` string, nullable, required
  - `dernier_avis` string, nullable, required
  - `dernier_avis_le` string, nullable, required
  - `connue_au_dpe` boolean, nullable, required: Vrai si une société civile était déjà domiciliée à l'adresse avant le dernier DPE ; null sans DPE ou sans société.
  - `donnees_du` string, nullable, required: Date du calcul de la gold à l'adresse (horodatage ISO 8601).
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `limites` string[], required: Ce que la réponse ne couvre pas, en clair.
  - `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 ; Opération coupée sur ce créneau

---

[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)