---
title: "Taxe d'aménagement d'un projet"
method: POST
path: "/fiscal/taxe-amenagement"
---

# Taxe d'aménagement d'un projet

`POST /fiscal/taxe-amenagement`

## Request

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

Taxe d'aménagement d'un projet de construction, d'agrandissement, de piscine ou de places de stationnement extérieures, avec le moteur des démarches d'urbanisme de pillr.fr : parts communale, départementale et régionale (Île-de-France) aux taux votés par les collectivités (délibérations notifiées à la DGFiP), ou au barème légal en fourchette quand la commune n'en publie pas, abattement de la résidence principale, piscine et places au forfait, taxe d'archéologie préventive, déclaration et paiement, chaque valeur avec sa source. Un fait manquant revient en question. Estimation indicative : seul l'avis de la DGFiP fixe le montant dû. Coût : 1 crédit par appel réussi.

## Request body

- object
  - `insee` string, required: Commune du terrain : ses taux et sa valeur forfaitaire.
  - `type_travaux` 'construction_nouvelle' | 'travaux_existant' | 'transformation_garage' | 'piscine' | 'cloture' | 'mur' | 'aspect_exterieur' | 'pompe_a_chaleur' | 'ravalement' | 'changement_destination' | 'division' | 'demolition': Nature des travaux ; par défaut construction_nouvelle avec une surface, piscine avec un bassin seul.
  - `formalite` 'aucune' | 'declaration_prealable' | 'permis_de_construire' | 'permis_d_amenager' | 'permis_de_demolir': Autorisation d'urbanisme du projet ; sans elle, la taxe est calculée pour un projet soumis à autorisation. aucune : rien n'est dû.
  - `surface_taxable_creee_m2` number: Surface taxable créée : close, couverte, de plus de 1,80 m sous plafond, en m².
  - `surface_taxable_existante_m2` number: Surface taxable existante du logement et de ses annexes, pour l'abattement.
  - `residence_principale` boolean: Résidence principale ou ses annexes : abattement de 50 % sur les 100 premiers m².
  - `piscine_m2` number: Surface du bassin, en m².
  - `places_exterieures` integer: Places de stationnement extérieures créées.
  - `affecte_sous_sol` boolean: Travaux qui affectent le sous-sol (fondations, terrassement) : taxe d'archéologie préventive.
  - `taux_communal_pct` number: Taux communal connu, en % (remplace celui des délibérations).
  - `taux_departemental_pct` number: Taux départemental connu, en %.

## Response `200`

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

- object
  - `insee` string, required
  - `statut` 'estimee' | 'non_due' | 'hors_calcul' | 'faits_manquants', required: estimee : montant ou fourchette ; non_due : rien n'est dû ; hors_calcul : cas que le moteur n'estime pas ; faits_manquants : les questions disent quoi donner.
  - `regle` string, required
  - `annee_valeurs` integer, required
  - `a_jour_le` string, required
  - `formule` string, required
  - `valeurs` object[], required
    - `libelle` string, required
    - `valeur` string, required
    - `sources` string[], required
  - `assiette` object[], required
    - `libelle` string, required
    - `calcul` string, required
    - `min` number, required
    - `max` number, required
    - `sources` string[], required
  - `assiette_min` number, required
  - `assiette_max` number, required
  - `parts` object[], required
    - `part` 'communale' | 'departementale' | 'regionale', required
    - `libelle` string, required
    - `taux` string, required
    - `taux_min` number, required
    - `taux_max` number, required
    - `montant_min` number, required
    - `montant_max` number, required
    - `source` string, required
    - `a_confirmer` boolean, required
  - `total_min` number, required
  - `total_max` number, required
  - `abattement_residence_principale` boolean, required: Vrai si l'abattement de 50 % sur les 100 premiers m² de la résidence principale entre dans l'assiette.
  - `archeologie` object, nullable, required
    - `statut` 'due' | 'si_sous_sol' | 'non_due', required
    - `taux_pct` number, required
    - `montant_min` number, required
    - `montant_max` number, required
    - `regle` string, required
    - `sources` string[], required
  - `faits_manquants` string[], required
  - `notes` string[], required
  - `a_confirmer` boolean, required
  - `declaration` object[], required
    - `etape` string, required
    - `sources` string[], required
  - `fiscalite_locale` object, nullable, required
    - `departement` string, nullable, required
    - `ile_de_france` boolean, nullable, required
    - `secteurs` object, nullable, required
      - `min` number, required
      - `max` number, required
    - `code_hors_bareme` boolean, required
    - `taux_annee_suivante` object, nullable, required
      - `annee` integer, required
      - `min` number, required
      - `max` number, required
      - `provisoire` boolean, required
    - `exoneration_abris_pct` object, required
      - `communale` number, nullable, required
      - `departementale` number, nullable, required
    - `stationnement_vote_eur` number, nullable, required
  - `hypotheses` string[], required
  - `sources` string[], 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

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