---
title: "Revenu de courte durée d'un logement"
method: POST
path: "/courte-duree/estimations"
---

# Revenu de courte durée d'un logement

`POST /courte-duree/estimations`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/courte-duree/estimations`
- Auth: HTTP bearer

Revenu de location courte durée d'un logement décrit par sa commune, sa surface et ses chambres, avec le modèle du simulateur de pillr.fr : capacité d'accueil, prix de nuit et occupation ajustés à la capacité depuis le profil de marché AirDNA de la commune, nuits ouvertes et réservées, montée en charge de la première année ; coûts d'exploitation (plateforme, conciergerie, renouvellement, ménage, linge, énergie, internet, assurance, classement), revenu net, statut réglementaire de la commune et du DPE, hypothèses et avertissements. Sans profil de marché, le revenu est un multiple du loyer nu, et le dit. Coût : 2 crédits par appel réussi.

## Request body

- object
  - `insee` string, required: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
  - `surface` number, required: Surface habitable, en m².
  - `chambres` integer: Chambres ; sans elles, la capacité est déduite de la surface.
  - `nuits_ouvertes` integer: Nuits ouvertes à la location dans l'année.
  - `occupation_pct` number: Occupation imposée, en % des nuits ouvertes ; sinon celle du marché, ajustée à la capacité.
  - `gestion` 'seul' | 'conciergerie': Gestion par l'investisseur seul, ou par une conciergerie (par défaut).
  - `classe` boolean: Meublé de tourisme classé (oui par défaut).
  - `dpe` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G': Étiquette DPE : une nouvelle autorisation l'exige suffisante.
  - `loyer_nu` number: Loyer mensuel en location nue, pour le repli et la comparaison ; sinon le loyer de marché de la commune.

## Response `200`

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

- object
  - `insee` string, required
  - `commune` string, nullable, required
  - `revenu` object, required
    - `capacite` integer, required: Couchages retenus : deux par chambre plus un, ou déduits de la surface.
    - `prix_nuit` number, required
    - `occupation_pct` number, required
    - `nuits_ouvertes` integer, required
    - `nuits_reservees` integer, required
    - `rotations` integer, required
    - `revenu_brut` number, required: Revenu annuel en régime de croisière, en euros.
    - `revenu_annee1` number, required: Revenu de la première année (montée en charge).
    - `ratio_loyer_nu` number, nullable, required: Revenu brut sur loyer nu annuel.
    - `confiance` 'mesure' | 'estime' | 'faible', required: mesure : marché AirDNA d'au moins 20 annonces ; estime : petit marché lissé avec son département, ou profil départemental ; faible : profil national ou anciennes données.
    - `source` 'airdna_market' | 'airdna_departement' | 'airdna_national' | 'legacy_dump' | 'loyer_nu', required
    - `notes` string[], required
    - `avertissements` 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.
  - `couts` object, required
    - `plateforme_pct` number, required
    - `conciergerie_pct` number, required
    - `renouvellement_pct` number, required
    - `plateforme` number, required
    - `conciergerie` number, required
    - `renouvellement` number, required
    - `menage` number, required
    - `linge` number, required
    - `energie` number, required
    - `internet` number, required
    - `assurance` number, required
    - `classement` number, required
    - `total` number, required: Coûts d'exploitation annuels, en euros, sur le revenu brut.
  - `revenu_net` number, required: Revenu brut moins coûts d'exploitation, avant charges de copropriété, taxe foncière, crédit et impôt.
  - `loyer_nu_mensuel` number, nullable, required: Loyer nu de comparaison : celui donné, ou loyer de marché au m² de la commune multiplié par la surface.
  - `statut_reglementaire` object, required
    - `niveau` 'libre' | 'declaration' | 'autorisation' | 'compensation' | 'dpe', required: libre : déclaration en mairie ; declaration : zone tendue, déclaration et numéro d'enregistrement ; autorisation : changement d'usage à obtenir ; compensation : changement d'usage avec compensation ; dpe : DPE qui ferme le meublé de tourisme.
    - `recommandable` boolean, required: Faux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).
    - `titre` string, required
    - `texte` string, required
  - `hypotheses` 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
- `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)