---
title: "Plus-value immobilière à la revente"
method: POST
path: "/fiscal/plus-value"
---

# Plus-value immobilière à la revente

`POST /fiscal/plus-value`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/fiscal/plus-value`
- Auth: HTTP bearer

Plus-value immobilière d'un particulier à la revente, avec le moteur fiscal de pillr.fr : durée de détention, prix d'acquisition majoré des frais (réels, ou forfait de 7,5 %) et des travaux (réels, ou forfait de 15 % après 5 ans), amortissements réintégrés en LMNP ou en bailleur privé, abattements pour durée de détention à l'impôt sur le revenu et aux prélèvements sociaux, impôt, prélèvements, surtaxe des plus-values élevées, impôt total et net vendeur. Exonération de la résidence principale. Aucun conseil fiscal. Coût : 1 crédit par appel réussi.

## Request body

- object
  - `prix_achat` number, required: Prix d'achat, en euros.
  - `date_achat` string, required: Date d'achat (AAAA-MM-JJ).
  - `frais_acquisition` number: Frais d'acquisition réels, en euros ; sans eux, le forfait de 7,5 % du prix d'achat.
  - `travaux` number: Travaux réels non déduits des revenus, en euros.
  - `travaux_forfait` boolean: Forfait travaux de 15 % du prix d'achat, au-delà de 5 ans de détention (à la place des travaux réels).
  - `prix_vente` number, required: Prix de vente, en euros.
  - `date_vente` string, required: Date de vente (AAAA-MM-JJ).
  - `residence_principale` boolean: Vente de la résidence principale : exonérée.
  - `regime` 'particulier' | 'lmnp' | 'bailleur_prive': lmnp ou bailleur_prive : les amortissements déduits sont réintégrés au prix d'acquisition.
  - `amortissements_deduits` number: Amortissements déduits pendant la détention, en euros.

## Response `200`

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

- object
  - `duree_detention_ans` integer, required
  - `prix_achat` number, required
  - `frais_acquisition` number, required
  - `frais_acquisition_mode` 'reels' | 'forfait', required: forfait : 7,5 % du prix d'achat, retenu quand les frais réels ne sont pas donnés.
  - `travaux` number, required
  - `travaux_mode` 'reels' | 'forfait' | 'aucun', required: forfait : 15 % du prix d'achat, après plus de 5 ans de détention.
  - `amortissements_reintegres` number, required
  - `prix_acquisition_majore` number, required: Prix d'achat, frais et travaux, diminué des amortissements réintégrés.
  - `prix_vente` number, required
  - `plus_value_brute` number, required: Prix de vente moins prix d'achat, frais et travaux.
  - `plus_value_imposable` number, required
  - `abattement_ir_pct` number, required
  - `abattement_ps_pct` number, required
  - `base_ir` number, required
  - `base_ps` number, required
  - `impot_ir` number, required
  - `prelevements_sociaux` number, required
  - `surtaxe` number, required
  - `impot_total` number, required
  - `plus_value_nette` number, required: Plus-value brute moins l'impôt total.
  - `net_vendeur` number, required: Prix de vente moins l'impôt total, avant remboursement d'un éventuel crédit.
  - `exoneration` object, nullable, required
    - `motif` string, required
    - `source` string, required
  - `taux` object, required
    - `impot_revenu_pct` number, required
    - `prelevements_sociaux_pct` number, required
  - `hypotheses` string[], required
  - `sources` 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

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