---
title: "Indice Travaux et état du parc en vente"
method: GET
path: "/travaux/{maille}"
---

# Indice Travaux et état du parc en vente

`GET /travaux/{maille}`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/travaux/{maille}`
- Auth: HTTP bearer

Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité. Coût : 2 crédits par appel réussi.

## Path parameters

- `maille` string, required: Code postal ou code INSEE de la commune.

## Query parameters

- `type_maille` 'code_postal' | 'insee': code_postal ou insee ; sans lui, le code est lu comme un code postal s'il en est un, sinon comme un code INSEE.
- `mois` string: Mois d'entrée des annonces au catalogue (AAAA-MM) ; par défaut le dernier calculé.
- `type` 'appartement' | 'maison': appartement ou maison ; par défaut, les deux et leur ensemble.

## Response `200`

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

- object
  - `maille` object, required
    - `type` 'code_postal' | 'insee', required
    - `code` string, required
  - `mois` string, required: Mois d'entrée des annonces au catalogue (AAAA-MM).
  - `segments` object[], required
    - `type_bien` 'appartement' | 'maison' | 'tous', required
    - `n` integer, required: Biens distincts lus (une fiche par bien, empreinte de diffusion).
    - `n_annonces` integer, required: Annonces analysées avant le dédoublonnage.
    - `etat_median` number, nullable, required: État visuel médian lu sur les photos, de 0 (à reprendre) à 100 (neuf).
    - `part_a_renover_pct` number, nullable, required: Part des biens à rénover d'après leurs photos, en %.
    - `cout_median` number, nullable, required: Coût médian des travaux (milieu de la fourchette du barème), en euros.
    - `cout_min_median` number, nullable, required
    - `cout_max_median` number, nullable, required
    - `cout_median_m2` number, nullable, required: Coût médian des travaux rapporté à la surface, en euros par m².
    - `incertitude_pct` object, required: Écart médian mesuré entre deux analyses d'un même bien sur le chiffrage, en % : l'incertitude du coût.
      - `bas` number, required
      - `haut` number, required
      - `mesuree_le` string, required
    - `photos_catalogue_exclues` integer, required: Annonces écartées parce que leurs photos sont des photos de catalogue.
    - `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.
  - `methode` string, required
  - `donnees_du` string, nullable, required: Date du calcul de l'indice (horodatage ISO 8601).
  - `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)