---
title: "Agences et réseaux immobiliers"
method: GET
path: "/agences/{siren}"
---

# Agences et réseaux immobiliers

`GET /agences/{siren}`

## Request

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

La fiche d'une agence immobilière par son SIREN, ou les agences d'un lieu (commune, code postal, département), d'une enseigne ou d'un réseau. Pour chacune : dénomination, enseigne, sigle, catégorie juridique, APE, établissements Sirene (SIRET, adresse, effectif, création, siège), agences des portails rattachées au SIREN avec leur enseigne ou réseau, domaines web, coordonnées professionnelles avec leur origine, mandats du dernier mois par commune, annonces en ligne, et les 20 derniers avis BODACC. Seules les adresses électroniques publiées par l'agence sont servies, jamais une adresse construite par motif. Aucune agence : 404 ressource_absente, rien n'est débité. Coût : 2 crédits par élément rendu.

## Path parameters

- `siren` string, required: Numéro SIREN de l'entreprise (9 chiffres, sans espace).

## Response `200`

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

- object
  - `donnees` object[], required: Les agences trouvées, par SIREN croissant.
    - `siren` string, required
    - `denomination` string, nullable, required: Dénomination de l'unité légale (ou nom d'usage d'un entrepreneur individuel immatriculé).
    - `enseigne` string, nullable, required
    - `sigle` string, nullable, required
    - `categorie_juridique` string, nullable, required: Catégorie juridique (code Insee).
    - `ape` string, nullable, required: Activité principale (code APE).
    - `entrepreneur_individuel` boolean, nullable, required: Vrai pour un entrepreneur individuel immatriculé, servi comme professionnel.
    - `diffusion_partielle` boolean, required: Vrai si l'unité est en diffusion partielle Sirene : son adresse n'est pas servie.
    - `etablissements` object[], required
      - `siret` string, required
      - `siege` boolean, nullable, required
      - `adresse` string, nullable, required: Numéro et voie de l'établissement ; null pour une unité en diffusion partielle.
      - `code_postal` string, nullable, required
      - `commune` string, nullable, required
      - `insee` string, nullable, required
      - `tranche_effectif` string, nullable, required: Tranche d'effectif salarié (code Sirene).
      - `cree_le` string, nullable, required
      - `actif` boolean, nullable, required: Faux pour un établissement fermé (état administratif F).
    - `reseaux` object[], required: Agences des portails rattachées au SIREN, avec leur enseigne ou réseau.
      - `enseigne` string, nullable, required: Enseigne ou réseau de franchise (Century 21, Laforêt...) ; null si l'agence n'en a pas.
      - `nom_commercial` string, nullable, required: Nom commercial publié sur le portail.
      - `identifiant_portail` string, required
      - `commune_principale` string, nullable, required
      - `departement_principal` string, nullable, required
      - `nb_annonces` integer, nullable, required
      - `rapprochement` string, nullable, required: Comment l'agence du portail a été rapprochée de son SIREN.
      - `calcule_le` string, nullable, required
    - `domaines` object[], required
      - `domaine` string, required
      - `genre` string, nullable, required: propre : site de l'agence ; heberge : site hébergé en marque blanche par un éditeur (le sous-domaine est l'agence).
      - `source` string, nullable, required
      - `observations` integer, nullable, required
    - `contacts_pro` object, nullable, required: Coordonnées professionnelles, avec leur origine.
      - `telephone` string, nullable, required: Téléphone professionnel publié ; null s'il est inconnu ou retiré.
      - `email` string, nullable, required: Adresse électronique PUBLIÉE par le professionnel (annonce, site, mentions légales) ; jamais une adresse construite par motif.
      - `site` string, nullable, required: Site web (domaine) ; null s'il est inconnu.
      - `origine` string, nullable, required: Où l'adresse électronique a été lue : published (publiée par le professionnel), desc_extracted (lue dans une annonce), site_legal (mentions légales du site).
      - `retirees` boolean, required: Vrai si le professionnel s'est opposé à nos envois : aucune coordonnée n'est alors servie.
    - `activite` object, required
      - `mois` string, nullable, required: Dernier mois calculé des mandats (AAAA-MM).
      - `mandats` integer, nullable, required: Mandats pris dans le mois, toutes communes.
      - `exclusifs` integer, nullable, required
      - `communes` object[], required: Les mandats du mois, par commune et par enseigne.
        - `insee` string, required
        - `enseigne` string, required
        - `mandats` integer, required
        - `exclusifs` integer, required
        - `duree_mediane_j` number, nullable, required
        - `part_baisses_pct` number, nullable, required
      - `annonces_actives` integer, nullable, required: Annonces en ligne rattachées au SIREN.
      - `annonces_par_commune` object[], required: Annonces en ligne par commune.
        - `commune` string, nullable, required
        - `code_postal` string, nullable, required
        - `nb_annonces` integer, nullable, required
      - `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.
    - `avis_bodacc` object[], required: Les 20 derniers avis BODACC du SIREN au plus (tous : /entreprises/{siren}).
      - `id` string, required: Identifiant de l'avis au BODACC.
      - `date` string, nullable, required: Date de parution (AAAA-MM-JJ).
      - `famille` string, nullable, required: Famille d'avis (code de la source : creation, modification, radiation, collective, vente, dpc...).
      - `famille_libelle` string, nullable, required
      - `type` string, nullable, required: Type d'avis (avis initial, rectificatif, annulation).
      - `numero_annonce` string, nullable, required
      - `parution` string, nullable, required: Numéro de parution du BODACC.
      - `tribunal` string, nullable, required
      - `ville` string, nullable, required
      - `cp` string, nullable, required
      - `departement` string, nullable, required
      - `denomination` string, nullable, required: Dénomination de la personne morale visée par l'avis ; null pour un avis qui porte sur une personne physique.
      - `sirens` string[], required: SIREN cités par l'avis ; vide pour une personne physique.
      - `porte_sur_personne_physique` boolean, nullable, required: Vrai si l'avis porte sur une personne physique : son identité, son registre et ses textes ne sont pas servis.
      - `contenu` object, required: Le contenu structuré de l'avis, tel que publié, en JSON.
        - `personnes` unknown, required
        - `etablissements` unknown, required
        - `jugement` unknown, required
        - `acte` unknown, required
        - `modifications_generales` unknown, required
        - `radiation_rcs` unknown, required
        - `depot` unknown, required
        - `divers` unknown, required
        - `precedents_proprietaires` unknown, required
        - `precedents_exploitants` unknown, required
        - `avis_precedent` unknown, required
      - `lien` string, nullable, required: Lien de l'avis sur bodacc.fr ; null pour un avis qui porte sur une personne physique.
      - `charge_le` string, nullable, required: Date de chargement de l'avis dans le lac de Pillr (horodatage ISO 8601).
    - `avis_bodacc_complets` boolean, required: Faux si l'entreprise a plus d'avis que ceux servis ici.
    - `sirene_du` string, nullable, required: Date de l'extrait Sirene lu (AAAA-MM-JJ).
  - `mention` string, required: Ce qui est servi des coordonnées, et ce qui ne l'est jamais.
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `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 ; Curseur invalide
- `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)