---
title: "Flux de nouveautés à l'adresse"
method: GET
path: "/flux/adresses"
---

# Flux de nouveautés à l'adresse

`GET /flux/adresses`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/flux/adresses`
- Auth: HTTP bearer

Les nouveautés datées à l'adresse, lues dans le journal tenu chaque nuit après la reconstruction de la donnée à l'adresse : nouveau DPE, nouvel audit énergétique, nouvelle autorisation d'urbanisme, nouvel avis d'une société civile au siège, nouvelle vente DVF. Chaque évènement porte la clé BAN, la date à la source, le détail et la source publique. Filtres : depuis (date d'entrée au journal), genres, communes, codes postaux. Le curseur_suivant est rendu même sur la dernière page : repassez-le plus tard, avec les mêmes filtres, pour ne lire que la suite. Coût : 1 crédit par évènement livré.

## Query parameters

- `depuis` string: Ne lire que les évènements entrés au journal depuis cette date.
- `genres` union: Genre, ou liste de genres ; tous si absent.
  - 'dpe' | 'audit' | 'permis' | 'societe_civile' | 'vente': dpe (nouveau DPE), audit (nouvel audit énergétique), permis (nouvelle autorisation d'urbanisme), societe_civile (nouvel avis d'une société civile au siège), vente (nouvelle vente DVF).
  - string[]
- `insee` union: Code INSEE, ou liste de 20 codes au plus (paramètre répété).
  - string: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
  - string[]
- `cp` union: Code postal, ou liste de 20 codes au plus.
  - string: Code postal.
  - string[]
- `limite` integer: Nombre d'éléments par page (1000 au plus).
- `curseur` string: Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

## Response `200`

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

- object
  - `evenements` union[], required: Les évènements, dans l'ordre du journal.
    - union
      - object
        - `id` string, required: Identifiant de l'évènement, croissant dans l'ordre du flux.
        - `le` string, required: Date de l'évènement à la source (AAAA-MM-JJ).
        - `journalise_le` string, required: Horodatage de l'entrée au journal (ISO 8601).
        - `cle_ban` string, required: Clé BAN de l'adresse.
        - `insee` string, nullable, required
        - `code_postal` string, nullable, required
        - `source` string, required: Source publique, en clair.
        - `genre` 'dpe', required
        - `detail` object, required
          - `etiquette` string, nullable, required
          - `ges` string, nullable, required
          - `conso_kwh_m2` number, nullable, required
          - `numero_dpe` string, nullable, required
          - `type_batiment` string, nullable, required
      - object
        - `id` string, required: Identifiant de l'évènement, croissant dans l'ordre du flux.
        - `le` string, required: Date de l'évènement à la source (AAAA-MM-JJ).
        - `journalise_le` string, required: Horodatage de l'entrée au journal (ISO 8601).
        - `cle_ban` string, required: Clé BAN de l'adresse.
        - `insee` string, nullable, required
        - `code_postal` string, nullable, required
        - `source` string, required: Source publique, en clair.
        - `genre` 'audit', required
        - `detail` object, required
          - `classe_visee` string, nullable, required
          - `cout_travaux_max` number, nullable, required
      - object
        - `id` string, required: Identifiant de l'évènement, croissant dans l'ordre du flux.
        - `le` string, required: Date de l'évènement à la source (AAAA-MM-JJ).
        - `journalise_le` string, required: Horodatage de l'entrée au journal (ISO 8601).
        - `cle_ban` string, required: Clé BAN de l'adresse.
        - `insee` string, nullable, required
        - `code_postal` string, nullable, required
        - `source` string, required: Source publique, en clair.
        - `genre` 'permis', required
        - `detail` object, required
          - `type` string, nullable, required
          - `nature` string, nullable, required
          - `logements_crees_7a` number, nullable, required: Logements créés à l'adresse sur 7 ans.
      - object
        - `id` string, required: Identifiant de l'évènement, croissant dans l'ordre du flux.
        - `le` string, required: Date de l'évènement à la source (AAAA-MM-JJ).
        - `journalise_le` string, required: Horodatage de l'entrée au journal (ISO 8601).
        - `cle_ban` string, required: Clé BAN de l'adresse.
        - `insee` string, nullable, required
        - `code_postal` string, nullable, required
        - `source` string, required: Source publique, en clair.
        - `genre` 'societe_civile', required
        - `detail` object, required
          - `avis` string, nullable, required: Nature du dernier avis publié.
          - `denomination` string, nullable, required: Dénomination de la société civile.
      - object
        - `id` string, required: Identifiant de l'évènement, croissant dans l'ordre du flux.
        - `le` string, required: Date de l'évènement à la source (AAAA-MM-JJ).
        - `journalise_le` string, required: Horodatage de l'entrée au journal (ISO 8601).
        - `cle_ban` string, required: Clé BAN de l'adresse.
        - `insee` string, nullable, required
        - `code_postal` string, nullable, required
        - `source` string, required: Source publique, en clair.
        - `genre` 'vente', required
        - `detail` object, required
          - `prix` number, nullable, required
          - `type` string, nullable, required
          - `surface` number, nullable, required
          - `prix_m2` number, nullable, required
  - `a_jour` boolean, required: Vrai quand le journal n'a plus rien à lire pour l'instant : repassez curseur_suivant plus tard pour reprendre.
  - `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.
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `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 ; Curseur invalide
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante ; Palier insuffisant
- `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)