---
title: "Pré-marché d'une adresse"
method: GET
path: "/adresses/{cle_ban}/pre-marche"
---

# Pré-marché d'une adresse

`GET /adresses/{cle_ban}/pre-marche`

## Request

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

Pour une adresse (clé BAN), la probabilité calibrée qu'une vente DVF y soit enregistrée dans les 12 mois, calculée à la lecture comme dans le Hub : indice des coefficients mesurés, bande de calibration et son taux de vente réel, lift, fenêtre de mandat et priorité, fiabilité (mesure sur les maisons positionnées, indicatif ailleurs), raisons chiffrées, coefficients retenus, faits datés au jour du DPE, frise des évènements de l'adresse (DPE, audit, ventes, sociétés civiles, permis, copropriété, annonce) et sociétés civiles domiciliées, nommées avec leur SIREN quand le BODACC le rattache. Hors du périmètre calibré (Alsace-Moselle notamment), la raison est servie à la place du calcul. Coût : 10 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
  - `hors_perimetre` string, nullable, required: Pourquoi l'adresse sort du périmètre calibré (Alsace-Moselle, DPE collectif, neuf livré, adresse sans position...) ; null si elle est calculée.
  - `adresse` object, nullable, required: Le calcul de l'adresse ; null hors du périmètre calibré.
    - `rang` integer, required
    - `cle_ban` string, required
    - `adresse` string, required
    - `commune` string, required
    - `code_postal` string, nullable, required
    - `insee` string, required
    - `lat` number, required
    - `lon` number, required
    - `type_bien` 'maison' | 'appartement' | 'immeuble' | 'autre', required
    - `dpe` string, nullable, required
    - `periode_construction` string, nullable, required
    - `chauffage` string, nullable, required
    - `dpe_le` string, required
    - `age_dpe_jours` integer, required
    - `audit_le` string, nullable, required
    - `pack_pre_vente` boolean, required
    - `p_vente` number, required: Probabilité calibrée qu'une vente DVF soit enregistrée à l'adresse dans les 12 mois.
    - `lift` number, nullable, required: p_vente divisée par le taux de vente mesuré du type de bien.
    - `fiabilite` 'mesure' | 'indicatif', required: mesure : maison positionnée dans la BAN, la population où la calibration est démontrée ; indicatif sinon.
    - `raisons` string[], required: Les coefficients réellement appliqués, du plus fort au plus faible, puis l'âge du DPE et la fenêtre de mandat.
    - `fenetre_mandat` object, required
      - `valeur` number, required: Part des vendeurs encore libres d'un mandat à cet âge du DPE (mesurée sur le délai entre le DPE et la première annonce).
      - `libelle` string, required
    - `priorite` number, required: p_vente multipliée par la fenêtre de mandat : l'ordre du classement.
    - `deja_en_vente` boolean, required
    - `annonce` object, nullable, required
      - `id` string, nullable, required
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
      - `parue_le` string, nullable, required
      - `prix` number, nullable, required
      - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required
      - `agence` object, nullable, required: L'agence qui publie l'annonce ; null pour un vendeur particulier ou inconnu.
        - `nom` string, nullable, required
        - `enseigne` string, nullable, required
        - `siren` string, nullable, required
    - `derniere_vente` object, nullable, required
      - `date` string, nullable, required
      - `prix` number, nullable, required
    - `annees_detention` number, nullable, required
    - `societes_civiles` object[], required
      - `denomination` string, nullable, required
      - `siren` string, nullable, required: SIREN lu dans le BODACC pour cette dénomination et ce code postal ; null s'il n'est pas rattaché sans ambiguïté.
      - `forme` string, nullable, required
      - `dernier_avis` string, nullable, required
      - `le` string, nullable, required
    - `permis` object, nullable, required
      - `n` integer, required
      - `dernier_le` string, nullable, required
      - `type` string, nullable, required
    - `copro` object, nullable, required
      - `lots` number, nullable, required
      - `syndic` string, nullable, required
    - `logements` object, required
      - `nombre` integer, nullable, required
      - `source` 'dpe' | 'copropriete' | 'maison', nullable, required
    - `frise` object[], required
      - `date` string, required
      - `type` 'dpe' | 'audit' | 'vente' | 'sci' | 'permis' | 'copro' | 'annonce', required
      - `libelle` string, required
      - `detail` string, nullable, required
      - `apres_dpe` boolean, required: Vrai si l'évènement est postérieur au dernier DPE.
  - `bande` object, nullable, required: La bande de calibration qui contient l'indice : son nombre d'adresses et son taux de vente mesuré.
    - `bande` integer, required
    - `n` integer, required
    - `indice_min` number, required
    - `indice_max` number, required
    - `taux_vente_12m_pct` number, required
  - `indice` number, nullable, required: Produit des coefficients mesurés (public.pre_marche_indice_v3).
  - `coefficients` object[], required: Les coefficients retenus pour ce type de bien, tels que mesurés.
    - `signal` string, required
    - `groupe` string, nullable, required
    - `coefficient` number, nullable, required
    - `lift_dvf` number, nullable, required
    - `n_dvf` number, nullable, required
  - `variables` object, nullable, required: Les faits datés au jour du DPE qui entrent dans l'indice.
    - `audit_connu` boolean, required
    - `annees_detention_au_dpe` number, nullable, required
    - `dpe_valide_au_dpe` boolean, required
    - `nb_dpe_365j_avant` number, nullable, required
    - `sci_connue_au_dpe` boolean, required
    - `ventes_ilot_avant_dpe` number, nullable, required
    - `ventes_numero_avant_dpe` number, nullable, required
    - `copro_ilot` boolean, required
    - `surface_m2` number, nullable, required
    - `multiplicateur_age_dpe` number, nullable, required
  - `precision` object, required
    - `base_pct` number, nullable, required: Taux de vente DVF à 12 mois mesuré du type de bien, en %.
    - `haut_pct` number, nullable, required: Taux mesuré dans la bande de probabilité la plus haute, en %.
    - `description` string, required
    - `mesure_le` 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.
  - `calcule_le` string, nullable, 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)