---
title: "Cerfa d'urbanisme pré-rempli"
method: POST
path: "/urbanisme/cerfa/{numero}"
---

# Cerfa d'urbanisme pré-rempli

`POST /urbanisme/cerfa/{numero}`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/urbanisme/cerfa/{numero}`
- Auth: HTTP bearer

Le PDF officiel d'un Cerfa d'urbanisme (lu sur formulaires.service-public.gouv.fr, dans la version vérifiée par Pillr), rempli des seules cases connues du dossier : adresse et superficie du terrain, références cadastrales, nature des travaux, annexes, emprise au sol créée, description du projet. L'identité, les coordonnées, l'engagement et la signature du demandeur ne sont jamais remplis : la réponse les liste avec les cases restées vides. En REST, la réponse est le PDF ; en MCP, la liste des cases remplies et vides, et le PDF en ressource. Si le formulaire officiel a changé depuis sa vérification, rien n'est rempli ni débité et les valeurs sont rendues pour une saisie à la main. Coût : 5 crédits par appel réussi.

## Path parameters

- `numero` string, required: Numéro du formulaire : 16702*03, 16703*03, 13406*17, 13409*17, 13405*15, 16297*05 (l'astérisque s'écrit aussi avec un tiret).

## Request body

- object
  - `donnees` object, required: Les faits du dossier, par clé de la table de correspondance.
    - `terrain.numero` string
    - `terrain.voie` string
    - `terrain.lieudit` string
    - `terrain.localite` string
    - `terrain.code_postal` string
    - `parcelle.prefixe` string
    - `parcelle.section` string
    - `parcelle.numero` string
    - `travaux.description` string
    - `annexe.autres_precision` string
    - `parcelle.superficie_m2` number
    - `terrain.superficie_totale_m2` number
    - `emprise.creee_m2` number
    - `travaux.nouvelle` boolean
    - `travaux.existante` boolean
    - `travaux.extension` boolean
    - `annexe.piscine` boolean
    - `annexe.garage` boolean
    - `annexe.veranda` boolean
    - `annexe.abri` boolean
    - `annexe.autres` boolean

## Response `200`

Le fichier, débité (sauf réponse identique déjà servie dans les 24 h). Les métadonnées sont dans x-pillr-metadonnees (structuredContent côté MCP).

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