---
title: "Histoire datée d'une adresse"
method: GET
path: "/adresses/{cle_ban}/histoire"
---

# Histoire datée d'une adresse

`GET /adresses/{cle_ban}/histoire`

## Request

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

La frise datée et sourcée d'une adresse, par sa clé BAN, l'adresse en texte ou un point : construction déclarée, DPE depuis 2013 et audits énergétiques, autorisations d'urbanisme depuis 2013 (demandeur personne morale nommé), ventes DVF depuis 2018 au numéro, à la parcelle ou par position, copropriété (syndic professionnel nommé), sociétés civiles domiciliées nommées avec leur SIREN, annonces passées et baisses de prix avec l'agence nommée, catastrophes naturelles de la commune depuis 1982 (Géorisques). Chaque évènement dit son rattachement (adresse, parcelle, immeuble, position ou commune) et chaque source son état. Le même moteur que l'outil Historimmo du Hub ; le nombre d'évènements est plafonné, la construction et la première vente toujours gardées. 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
  - `adresse` object, required
    - `libelle` string, required
    - `cle_ban` string, nullable, required
    - `insee` string, required
    - `code_postal` string, nullable, required
    - `commune` string, required
    - `numero` string, nullable, required
    - `suffixe` string, nullable, required
    - `voie` string, nullable, required
    - `code_voie` string, nullable, required
    - `lat` number, required
    - `lon` number, required
    - `parcelles` string[], required
    - `score_geocodage` number, nullable, required
  - `bien` object, nullable, required
    - `type_bien` string, nullable, required
    - `surface_m2` number, nullable, required
    - `annee_construction` number, nullable, required
    - `periode_construction` string, nullable, required
    - `etiquette_dpe` string, nullable, required
    - `etiquette_ges` string, nullable, required
    - `chauffage` string, nullable, required
    - `nombre_niveaux` number, nullable, required
    - `nombre_logements` number, nullable, required
    - `copro_lots` number, nullable, required
    - `copro_type_syndic` string, nullable, required
  - `evenements` object[], required: Du plus ancien au plus récent ; la construction et la première vente sont toujours gardées.
    - `id` string, required
    - `date` string, required
    - `date_precision` 'jour' | 'mois' | 'annee', required
    - `type` string, required: construction, dpe, audit, vente, annonce_parue, annonce_baisse, annonce_retiree, permis_construire, declaration_prealable, permis_amenager, permis_demolir, ouverture_chantier, achevement_travaux, copro_immatriculation, copro_reglement, copro_fin_mandat, societe_civile, catastrophe_naturelle.
    - `famille` 'bien' | 'transaction' | 'marche' | 'urbanisme' | 'copropriete' | 'societe' | 'commune', required
    - `titre` string, required
    - `detail` string, nullable, required
    - `valeurs` object[], required
      - `libelle` string, required
      - `valeur` string, required
    - `source` string, required
    - `rattachement` 'adresse' | 'parcelle' | 'position' | 'immeuble' | 'commune', required: À quel point l'évènement est rattaché à l'adresse : même adresse, même parcelle, par position, un autre lot du même immeuble, ou la commune.
    - `lien` string, nullable, required: Lien public (annonce d'origine avec la portée lien_origine, texte officiel).
  - `periode` object, required
    - `debut` string, nullable, required
    - `fin` string, nullable, required
  - `sources` object[], required
    - `id` string, required
    - `libelle` string, required
    - `depuis` integer, nullable, required
    - `statut` 'ok' | 'vide' | 'indisponible', required
    - `nb` integer, required
    - `note` string, nullable, required
  - `resume` object, required
    - `nb_evenements` integer, required
    - `nb_ventes` integer, required
    - `derniere_vente` object, nullable, required
      - `date` string, required
      - `prix` number, nullable, required
    - `premier_evenement` object, nullable, required
      - `date` string, required
      - `titre` string, required
    - `en_vente` boolean, required
  - `mise_en_vente` object, nullable, required: La mise en vente de l'adresse : déduite du rattachement d'annonces à l'adresse, jamais déclarée par le vendeur. La confiance et la méthode disent comment lire la valeur.
    - `deja_en_vente` boolean, nullable, required: Une annonce en cours est rattachée à l'adresse (concordance ou empreinte active).
    - `mise_en_vente_le` string, nullable, required: Première parution de la mise en vente en cours, lue par l'empreinte de l'adresse.
    - `derniere_parution_le` string, nullable, required
    - `concordante` object, nullable, required: L'annonce rattachée par croisement, avec sa confiance et sa méthode.
      - `active` boolean, nullable, required: L'annonce rattachée est-elle encore en ligne ?
      - `nb` number, nullable, required: Annonces rattachées à l'adresse par cette méthode.
      - `id` string, nullable, required: Identifiant de l'annonce au lac de Pillr.
      - `prix` number, nullable, required
      - `surface_m2` number, nullable, required
      - `type_vendeur` 'professionnel' | 'particulier', nullable, required: Professionnel ou particulier, selon le portail ; null si le portail ne le dit pas.
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
      - `confiance` number, nullable, required: Confiance du rattachement de l'annonce à l'adresse, de 0 à 1.
      - `methode` string, nullable, required: Méthode du rattachement (croisement DVF et DPE, DPE et copropriété, etc.).
    - `empreinte` object, nullable, required: L'annonce reconnue par l'empreinte de l'adresse.
      - `active` boolean, nullable, required
      - `nb` number, nullable, required: Parutions reconnues comme le même bien à cette adresse.
      - `id` string, nullable, required
      - `parue_le` string, nullable, required
      - `prix` number, nullable, required
      - `type_vendeur` 'professionnel' | 'particulier', nullable, required: Professionnel ou particulier, selon le portail ; null si le portail ne le dit pas.
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
    - `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.
  - `societes_civiles` object, nullable, required: Sociétés civiles (personnes morales) dont le siège est à l'adresse, nommées avec leur SIREN quand l'avis le porte.
    - `n` integer, required: Sociétés civiles dont le siège est à l'adresse.
    - `derniere_denomination` string, nullable, required
    - `dernier_avis` string, nullable, required
    - `dernier_avis_le` string, nullable, required
    - `radiation_le` string, nullable, required: Dernier avis de radiation ou de dissolution.
    - `procedure_le` string, nullable, required: Dernier avis de procédure collective.
    - `cession_le` string, nullable, required: Dernier avis de vente ou de cession.
    - `societes` object[], required
      - `denomination` string, required
      - `siren` string, nullable, required
      - `forme` string, nullable, required
      - `avis` object[], required
        - `date` string, required
        - `type` 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.
  - `alternatives` object[], required: Autres adresses proposées par la BAN quand la saisie est ambiguë ; vide sinon.
    - `libelle` string, required
    - `cle_ban` string, nullable, required
    - `score` number, nullable, required
  - `note` string, required
  - `calcule_le` 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 ; 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)