---
title: "Fiches de mesure des modèles"
method: GET
path: "/modeles"
---

# Fiches de mesure des modèles

`GET /modeles`

## Request

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

La fiche de mesure de chaque modèle de Pillr, avec la date et l'échantillon de chaque mesure : erreur de l'estimation sur des ventes DVF (avec et sans adresse) et couverture de sa fourchette ; reproductibilité du chiffrage des travaux et de l'état visuel ; calibration du pré-marché par bande et par type de bien (taux de vente DVF à 12 mois), coefficients, coefficients ajustés et AUC, décroissance par âge du DPE, précision des cohortes ; méthode et limites du barème de prix au m² et du loyer de marché. Sans modèle, toutes les fiches. Une mesure absente se dit dans les limites, jamais par un chiffre de remplacement. Coût : 0 crédit par appel réussi.

## Response `200`

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

- object
  - `modeles` object[], required
    - `modele` 'estimation' | 'pre_marche' | 'travaux' | 'bareme_prix' | 'loyer', required
    - `titre` string, required
    - `methode` string, required
    - `source` string, required
    - `mesures` object[], required
      - `indicateur` string, required
      - `libelle` string, required
      - `valeur` number, required
      - `unite` string, required
      - `mesure_le` string, nullable, required
      - `echantillon` integer, nullable, required: Nombre d'observations de la mesure.
      - `perimetre` string, nullable, required: Sur quoi porte la mesure (avec adresse, sans adresse, type de bien...).
      - `hors_echantillon` boolean, nullable, required: Vrai si la mesure a été faite sur des données que le modèle n'a pas vues ; null si sans objet.
    - `calibration` object[], required: Pré-marché : taux de vente DVF à 12 mois mesuré par bande d'indice.
      - `type_bien` string, required
      - `bande` integer, required
      - `indice_min` number, nullable, required
      - `indice_max` number, nullable, required
      - `n` integer, nullable, required
      - `taux_vente_12m_pct` number, nullable, required
      - `calcule_le` string, nullable, required
    - `coefficients` object[], required: Pré-marché : coefficient mesuré de chaque signal.
      - `type_bien` string, required
      - `signal` string, required
      - `groupe` string, nullable, required
      - `n_dvf` integer, nullable, required
      - `taux_dvf_pct` number, nullable, required
      - `lift_dvf` number, nullable, required
      - `n_mise_en_vente` integer, nullable, required
      - `taux_mise_en_vente_pct` number, nullable, required
      - `lift_mise_en_vente` number, nullable, required
      - `stable` boolean, nullable, required
      - `retenu` boolean, nullable, required
      - `coefficient` number, nullable, required
      - `calcule_le` string, nullable, required
    - `coefficients_ajustes` object[], required: Pré-marché : coefficients ajustés (rapports de cotes) et AUC du modèle.
      - `type_bien` string, required
      - `verite` string, required: La vérité mesurée (vente DVF, mise en vente).
      - `signal` string, required
      - `n` integer, nullable, required
      - `prevalence_pct` number, nullable, required
      - `odds_ratio` number, nullable, required
      - `taux_base_pct` number, nullable, required
      - `auc` number, nullable, required
      - `calcule_le` string, nullable, required
    - `decroissance` object[], required: Pré-marché : multiplicateur de l'âge du DPE (pack DPE et audit, ou DPE seul).
      - `pack` boolean, required
      - `age_min` integer, required
      - `age_max` integer, nullable, required
      - `multiplicateur` number, nullable, required
    - `cohortes` object[], required: Pré-marché : précision hebdomadaire des cohortes suivies.
      - `semaine` string, nullable, required
      - `type_bien` string, nullable, required
      - `cohorte` string, nullable, required
      - `seuil_score` number, nullable, required
      - `n_haut` integer, nullable, required
      - `mise_en_vente_haut_pct` number, nullable, required
      - `mise_en_vente_base_pct` number, nullable, required
      - `lift_mise_en_vente` number, nullable, required
      - `n_haut_dvf` integer, nullable, required
      - `vendu_haut_pct` number, nullable, required
      - `vendu_base_pct` number, nullable, required
      - `lift_vendu` number, nullable, required
      - `calcule_le` string, nullable, required
    - `limites` 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

---

[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)