---
title: "Dossier d'un immeuble de rapport"
method: GET
path: "/annonces/{id}/immeuble"
---

# Dossier d'un immeuble de rapport

`GET /annonces/{id}/immeuble`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/annonces/{id}/immeuble`
- Auth: HTTP bearer

Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour une annonce d'immeuble du catalogue Pillr, par son identifiant. Coût : 10 crédits par appel réussi.

## Path parameters

- `id` string, required: Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

## Response `200`

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

- object
  - `annonce` object, required: L'annonce de l'immeuble ; le vendeur n'y est jamais nommé.
    - `id` string, nullable, required: Identifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.
    - `source` string, required
    - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
    - `titre` string, nullable, required
    - `commune` string, nullable, required
    - `code_postal` string, nullable, required
    - `insee` string, nullable, required
    - `prix` number, nullable, required
    - `surface_m2` number, nullable, required
    - `pieces` number, nullable, required
    - `dpe` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required
  - `bloc_1_lots` object, required
    - `disponible` boolean, required
    - `confiance` 'mesure' | 'indice' | 'inconnu', required: mesure : lots énumérés dont la surface cumulée concorde à 20 % près avec la surface annoncée ; indice : lots énumérés sans concordance ; inconnu : aucun DPE exploitable.
    - `nb_lots` integer, required
    - `nb_lots_annonce` integer, nullable, required: Nombre de logements que le titre ou la description annonce.
    - `adresse` string, nullable, required: Adresse BAN des DPE retenus.
    - `surface_cumulee_m2` number, nullable, required
    - `surface_annoncee_m2` number, nullable, required
    - `ecart_surface_pct` number, nullable, required
    - `lots` object[], required
      - `surface_m2` number, nullable, required
      - `etiquette_dpe` string, nullable, required
      - `dpe_etabli_le` string, nullable, required
    - `desaccord` string, nullable, required
    - `autres_candidats` object[], required
      - `adresse` string, nullable, required
      - `nb_lots` integer, required
      - `surface_cumulee_m2` number, nullable, required
    - `methode` string, 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.
  - `bloc_2_etat_locatif` object, required
    - `loyer_m2_commune` number, nullable, required
    - `loyer_source` string, nullable, required
    - `loyer_mensuel_estime` number, nullable, required
    - `loyer_annuel_estime` number, nullable, required
    - `rendement_brut_pct` number, nullable, required
    - `detail_lots` object[], required
      - `surface_m2` number, nullable, required
      - `etiquette_dpe` string, nullable, required
      - `loyer_mensuel_eur` number, nullable, required
    - `methode` string, required
    - `decoupe` object, required
      - `disponible` boolean, required
      - `en_lots_de_40_m2` object, nullable, required
        - `nb_lots` integer, required
        - `surface_par_lot_m2` number, required
        - `loyer_mensuel` number, nullable, required
        - `ecart_pct` number, nullable, required: Écart au loyer de la configuration actuelle, en %.
      - `en_lots_de_30_m2` object, nullable, required
        - `nb_lots` integer, required
        - `surface_par_lot_m2` number, required
        - `loyer_mensuel` number, nullable, required
        - `ecart_pct` number, nullable, required: Écart au loyer de la configuration actuelle, en %.
      - `loyer_m2_t1_t2` number, nullable, required
      - `loyer_m2_t3plus` number, nullable, required
      - `source` string, nullable, required
      - `avertissement` string, 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.
  - `bloc_3_prix` object, required
    - `disponible` boolean, required
    - `maille` 'commune' | 'departement', nullable, required
    - `prix_m2_unite` number, nullable, required
    - `prix_m2_bloc` number, nullable, required
    - `rapport` number, nullable, required
    - `n_unite` integer, required
    - `n_bloc` integer, required
    - `position` string, nullable, required: Le prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.
    - `avertissement` string, 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.
  - `bloc_4_fiscalite` object, required
    - `seuil_micro_bic_par_lot_eur` number, required
    - `seuil_micro_foncier_eur` number, required
    - `seuil_cotisations_sociales_lcd_eur` number, required
    - `particularites` string[], required
  - `bloc_5_risques` object, required
    - `calendrier_energetique` string, nullable, required
    - `concentration` string, required
    - `lots_sous_contrainte` integer, nullable, required: Lots en F ou G parmi les lots établis.
    - `a_verifier` string[], required
  - `ordre` string, required
  - `calcule_le` 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)