---
title: "Potentiel de division d'un bien"
method: GET
path: "/annonces/{id}/division"
---

# Potentiel de division d'un bien

`GET /annonces/{id}/division`

## Request

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

Potentiel de division d'une annonce analysée, par la règle du Hub : la parcelle cadastrale du point de l'annonce (contenance, section, numéro, lue en direct à l'API Carto de l'IGN) croisée avec la surface habitable, le terrain déclaré, le prix au m² face au prix de référence de la commune et la demande locative. Rend un verdict (faible, modéré ou élevé) et ses signaux. Le point d'une annonce est souvent approché : la parcelle est celle du point servi, avec sa précision. Rien n'est débité si l'annonce est absente. Coût : 3 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
  - `id` string, required
  - `id_portail` string, nullable, required
  - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required: Statut du vendeur : pro (professionnel nommé), particulier, ou inconnu quand le portail ne le dit pas. Une annonce qui n'est pas celle d'un professionnel perd les téléphones et les emails de ses textes.
  - `commune` string, nullable, required
  - `surface_bien_m2` number, nullable, required
  - `pieces` number, nullable, required
  - `terrain_annonce_m2` number, nullable, required: Terrain déclaré par le portail.
  - `prix_m2_bien` number, nullable, required
  - `prix_m2_marche` number, nullable, required
  - `ecart_prix_m2_pct` number, nullable, required
  - `score_demande` number, nullable, required: Score de demande locative de la commune, sur 100.
  - `point` object, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `precision` string, required: adresse, approchee, centre de la commune ou inconnue : la précision du point donné par le portail.
  - `parcelle` object, nullable, required: Parcelle cadastrale qui contient le point de l'annonce (API Carto de l'IGN) ; null sans point ou sans réponse.
    - `contenance_m2` number, nullable, required
    - `section` string, nullable, required
    - `numero` string, nullable, required
    - `commune` string, nullable, required
  - `potentiel_decoupe` 'faible' | 'modere' | 'eleve', required
  - `signaux` 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.
  - `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)