---
title: "Enregistrer l'adresse validée d'une annonce"
method: POST
path: "/annonces/{id}/adresse-validee"
---

# Enregistrer l'adresse validée d'une annonce

`POST /annonces/{id}/adresse-validee`

## Request

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

Enregistre l'adresse que l'utilisateur de la clé a confirmée pour une annonce, dans le cache partagé des localisations de Pillr : une adresse par annonce, la dernière validation remplace la précédente. Elle est ensuite rendue par adresse_annonce et par localiser_annonce (etape disque), et le Hub la lit aussi. Exige une clé rattachée à un compte Pillr. Exige une clé rattachée à un compte Pillr. Coût : 0 crédit par appel réussi.

## Path parameters

- `id` string, required: Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

## Request body

- object
  - `libelle` string, required: L'adresse confirmée, en clair.
  - `lat` number
  - `lon` number
  - `precision` 'numero' | 'rue' | 'lieu_dit' | 'commune': Précision de l'adresse confirmée.
  - `confiance` string: Ce qui fonde la validation (Street View, DPE...).

## Response `200`

Écriture faite et débitée selon le barème.

- object
  - `enregistre` boolean, required
  - `id` string, required: Identifiant Pillr de l'annonce.
  - `libelle` string, required
  - `note` string, 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

- `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 ; Clé sans compte rattaché
- `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)