---
title: "Adresse retrouvée d'une annonce"
method: GET
path: "/annonces/{id}/adresse"
---

# Adresse retrouvée d'une annonce

`GET /annonces/{id}/adresse`

## Request

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

Adresse retrouvée d'une annonce floutée, de trois façons, chacune avec sa qualité : l'adresse résolue par le croisement de sources indépendantes dans le disque de flou (ventes DVF, DPE, copropriétés, parcelles), avec sa confiance, sa méthode, la distance entre les sources et la clé BAN quand la Base Adresse Nationale la retrouve au numéro ; les adresses que désigne l'empreinte du DPE affiché (numéro de DPE, clé BAN, écart de surface), ambiguë quand elle en désigne plusieurs ; l'adresse validée par un utilisateur de Pillr. La résolution n'est pas relancée à l'appel : elle date du dernier passage du résolveur (resolue_le). Rien n'est débité si aucune des trois n'existe. Coût : 5 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, nullable, required: Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
  - `id_portail` string, nullable, required: Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
  - `resolue` object, nullable, required: Adresse résolue par le croisement de sources indépendantes dans le disque de flou ; null si l'annonce n'a pas été résolue.
    - `adresse` string, nullable, required
    - `cle_ban` string, nullable, required: Clé BAN de l'adresse résolue, quand la Base Adresse Nationale la retrouve au numéro ; null sinon.
    - `lat` number, required
    - `lon` number, required
    - `confiance` number, required: Confiance du résolveur, de 0 à 1.
    - `methode` string, required: Croisement retenu (dvf_x_dpe, dpe_x_copro, dvf_x_copro, dvf_x_parcelle, dpe_x_parcelle...).
    - `sources` string[], required: Sources indépendantes qui concordent (dvf, dpe, copro, parcelle).
    - `concordance_m` integer, nullable, required: Distance entre les positions des sources concordantes, en mètres.
    - `rayon_disque_m` integer, nullable, required: Rayon du flou de l'annonce au moment de la résolution, en mètres.
    - `resolue_le` string, nullable, required
    - `version` string, nullable, required: Version du résolveur.
    - `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.
  - `empreinte_dpe` object, nullable, required: Adresses retrouvées par l'empreinte du DPE affiché (étiquette, surface, date) ; null si aucune.
    - `n_adresses` integer, required: Adresses que l'empreinte du DPE affiché désigne ; plus d'une : empreinte ambiguë.
    - `candidats` object[], required
      - `numero_dpe` string, required
      - `cle_ban` string, nullable, required
      - `date_dpe` string, nullable, required
      - `type_batiment` string, nullable, required
      - `ecart_surface_m2` number, nullable, required: Écart entre la surface du DPE et celle de l'annonce, en m².
    - `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.
  - `validee` object, nullable, required: Adresse confirmée par un utilisateur de Pillr (cache partagé des localisations) ; null si aucune.
    - `adresse` string, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `precision` 'numero' | 'rue' | 'lieu_dit' | 'commune', nullable, required
    - `confiance` string, nullable, required: Ce qui a fondé la validation, en clair (Street View, DPE...).
    - `le` string, nullable, required: Date de la validation.
    - `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)