---
title: "Entreprise : avis BODACC et autorisations"
method: GET
path: "/entreprises/{siren}"
---

# Entreprise : avis BODACC et autorisations

`GET /entreprises/{siren}`

## Request

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

Une entreprise par son SIREN : tous ses avis BODACC depuis 2009 (création, modifications, radiation, ventes et cessions, procédures collectives, dépôts des comptes), avec leur contenu structuré (établissements, jugements, actes), ses établissements Sirene de l'immobilier, ses autorisations d'urbanisme (Sitadel) et, si c'est une agence, ses enseignes et ses mandats par commune. Les personnes physiques d'un avis (gérants, associés) ne gardent que leur qualité ; un avis qui porte sur une personne physique ne sert ni son identité ni ses textes. Filtres : familles d'avis et date de début. SIREN inconnu de toutes les sources : 404 ressource_absente, rien n'est débité. Coût : 3 crédits par appel réussi.

## Path parameters

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

## Query parameters

- `familles` union: Ne garder que ces familles d'avis (une ou plusieurs).
  - 'creation' | 'immatriculation' | 'modification' | 'radiation' | 'collective' | 'conciliation' | 'retablissement_professionnel' | 'vente' | 'dpc': Famille d'avis du BODACC : creation, immatriculation, modification, radiation, collective (procédure collective), conciliation, retablissement_professionnel, vente (vente et cession), dpc (dépôt des comptes).
  - string[]
- `depuis` string: Ne garder que les avis parus à partir de cette date (AAAA-MM-JJ).

## Response `200`

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

- object
  - `siren` string, required
  - `denomination` string, nullable, required
  - `forme` string, nullable, required: Forme juridique (lue au BODACC) ou catégorie juridique (Sirene).
  - `categorie_juridique` string, nullable, required
  - `ape` string, nullable, required
  - `sigle` string, nullable, required
  - `entrepreneur_individuel` boolean, nullable, required
  - `adresse_siege` unknown, required
  - `identite_lue` 'sirene' | 'bodacc' | 'aucune', required: D'où viennent la dénomination et la forme.
  - `etablissements` object[], required: Établissements Sirene de l'immobilier rattachés au SIREN.
    - `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).
  - `n_avis` integer, required
  - `avis` object[], required: Avis BODACC depuis 2009, le plus récent d'abord, filtrés par familles et date si demandé.
    - `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_tronques` boolean, required: Vrai si l'entreprise a plus de 1000 avis : les plus anciens ne sont pas servis.
  - `permis` object[], required: Autorisations d'urbanisme déposées par l'entreprise (Sitadel).
    - `source` string, required: logements, locaux, demolir ou amenager (fichiers Sitadel).
    - `numero` string, nullable, required
    - `date` string, nullable, required: Date de l'autorisation (AAAA-MM-JJ).
    - `ligne` unknown, required
  - `agence` object, nullable, required: Si l'entreprise est une agence vue sur les portails : ses enseignes et ses mandats par commune ; null sinon.
    - `reseaux` object[], required
      - `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
    - `mandats_par_commune` object[], required
      - `insee` string, required
      - `enseigne` string, required
      - `mandats` integer, required
      - `exclusifs` integer, required
      - `duree_mediane_j` number, nullable, required
      - `part_baisses_pct` number, nullable, required
      - `mois` string, nullable, required
  - `donnees_du` string, nullable, required: Date du plus récent avis servi.
  - `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
  - `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)