---
title: "Baromètre, en lot"
method: POST
path: "/barometre/lot"
---

# Baromètre, en lot

`POST /barometre/lot`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/barometre/lot`
- Auth: HTTP bearer

Baromètre pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité. Coût : 1 crédit par élément rendu.

## Request body

- object
  - `elements` object[], required: Les entrées de l'opération unitaire, 100 au plus.
    - `edition` string, required: Édition (AAAA-MM), ou courante.
    - `echelle` 'france' | 'departement' | 'commune': france (défaut), departement ou commune.
    - `cle` string: Code du département (echelle departement) ou code INSEE (echelle commune).

## Response `200`

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

- object
  - `resultats` union[], required: Un résultat par élément, dans l'ordre de l'entrée : la sortie de l'opération, ou l'erreur de cet élément.
    - union
      - object
        - `index` integer, required
        - `ok` true, required
        - `donnees` object, required
          - `edition` string, required
          - `donnees_au` string, required: Date d'arrêt des données de l'édition (AAAA-MM-JJ).
          - `methode` string, required: Version de la méthode.
          - `revision` string, required
          - `echelle` 'france' | 'departement' | 'commune', required
          - `cle` string, required: FR, code du département ou code INSEE.
          - `nom` string, required
          - `mesures` object[], required
            - `cle` string, required: Identifiant de la mesure dans le registre (fg, baisse, prixA...).
            - `libelle` string, required
            - `nature` string, required: annonce, vente, diag, recens ou loyer.
            - `unite` string, required
            - `valeur` number, nullable, required: La valeur de l'édition, servie même sous le seuil de publication du site ; null si elle n'existe pas à cette échelle.
            - `n` integer, nullable, required: Effectif derrière la valeur, quand la mesure en a un.
            - `seuil_publication` integer, nullable, required: Effectif minimal pour que le site publie la valeur.
            - `seuil_classement` integer, nullable, required
            - `publiee` boolean, required: Vrai si le site publie la valeur (effectif suffisant, prix de référence assez précis).
            - `motif` 'non_disponible' | 'sous_seuil', nullable, required: Pourquoi le site ne publie pas la valeur ; null si elle est publiée.
            - `intervalle` object, nullable, required: Intervalle de confiance à 95 %, quand la mesure en a un.
              - …
            - `date` string, required: Date de la mesure dans cette édition.
            - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
              - …
          - `registre` object[], required: Le registre des mesures du baromètre, seuils de publication compris.
            - `cle` string, required
            - `libelle` string, required
            - `nature` string, required
            - `unite` string, required
            - `echelles` string[], required
            - `source` string, required
            - `calcul` string, required
            - `seuil` string, required
            - `limite` string, required
            - `seuil_publication` integer, nullable, required
            - `seuil_classement` integer, nullable, required
          - `calcule_le` string, required
      - object
        - `index` integer, required
        - `ok` false, required
        - `erreur` object, required
          - `code` string, required: Code stable de l'erreur (lib/api/v1/erreurs.ts).
          - `detail` string, required
  - `n_ok` integer, required
  - `n_erreurs` integer, 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
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API 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)