Démarches et dossiers
De la formalité au dossier de dépôt complet : démarche, croquis, coupes, Cerfa, échéances, rendu. 8 opérations servies.
Démarche d'urbanisme d'un projet
Essayer en direct/api/v1/urbanisme/demarcheDémarche d'urbanisme d'un projet de travaux décrit, sans adresse : formalité (aucune, déclaration préalable, permis de construire, d'aménager ou de démolir), formulaire Cerfa, architecte obligatoire ou non, pièces du dossier avec l'opération qui les prépare, délai d'instruction et valeur du silence de la mairie, taxe d'aménagement estimée (aux taux votés par la commune quand son code INSEE est donné, sinon en fourchette du barème légal) et redevance d'archéologie préventive, chaque conclusion avec sa règle et sa source, et la date de la base de règles. Un fait manquant revient en question, jamais en supposition. La zone du PLU et les servitudes ne sont pas lues : les protections du terrain se déclarent en paramètres (urbanisme_adresse les donne pour une adresse). Information générale, ni conseil juridique ni décision de la mairie.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- demarche_urbanisme
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 3 s
Paramètres
type_travauxtexteobligatoireNature des travaux. Une annexe séparée est une construction_nouvelle ; une extension ou une véranda accolée, des travaux_existant.
Valeurs :
construction_nouvelle,travaux_existant,transformation_garage,piscine,cloture,mur,aspect_exterieur,pompe_a_chaleur,ravalement,changement_destination,division,demolitionemprise_au_sol_creee_m2nombreEmprise au sol créée, en m² (un carport ou un garage compte même sans surface de plancher).
de 0 à 1 000 000
surface_plancher_creee_m2nombreSurface de plancher créée, ou surface close transformée pour un garage, en m².
de 0 à 1 000 000
hauteur_mnombreHauteur de la construction ou du mur, en mètres.
de 0 à 1 000 000
surface_plancher_existante_m2nombreSurface de plancher du bâtiment existant, en m².
de 0 à 1 000 000
emprise_au_sol_existante_m2nombreEmprise au sol du bâtiment existant, en m².
de 0 à 1 000 000
modifie_aspect_exterieurbooléenmodifie_volumebooléenvisible_espace_publicbooléenbassin_m2nombrePiscine : surface du bassin, en m².
de 0 à 1 000 000
hauteur_couverture_mnombrePiscine : hauteur de la couverture en mètres, 0 si non couverte.
de 0 à 1 000 000
piscine_demontablebooléenduree_installation_moisnombrePiscine démontable : mois d'installation par an.
de 0 à 1 000 000
duree_installation_joursnombrePiscine démontable en espace protégé : jours d'installation par an.
de 0 à 1 000 000
deliberation_communalebooléenLa commune a soumis clôtures ou ravalements à déclaration par délibération.
secteur_cloture_plubooléenClôture dans un secteur délimité par le PLU.
reparation_a_l_identiquebooléenpac_visiblebooléenPompe à chaleur visible depuis l'espace public, la voie ou les autres bâtiments.
date_debut_travauxtexteDate de début des travaux, si elle est passée.
ravalement_change_couleursbooléenchangementtexteValeurs :
destination,sous_destinationtravaux_structure_ou_facadebooléenequipements_communsbooléenDivision : création de voies, espaces ou équipements communs.
date_depottexteDivision : date de dépôt prévue (par défaut, aujourd'hui).
permis_demolir_instituebooléenrestauration_immobilierebooléeninclut_demolitionbooléendemandeurtexteQui dépose la demande (une SCI est une société).
Valeurs :
personne_physique,exploitation_agricole,societemaison_individuellebooléenserre_productionbooléenhauteur_pied_droit_mnombreSerre : hauteur du pied-droit, en mètres.
de 0 à 1 000 000
erp_ou_ighbooléenÉtablissement recevant du public ou immeuble de grande hauteur.
participation_du_publicbooléenevaluation_environnementalebooléensprbooléenTerrain en site patrimonial remarquable.
abords_monument_historiquebooléenTerrain aux abords d'un monument historique.
site_classebooléensite_inscritbooléenreserve_naturellebooléenelement_protege_plubooléenBâtiment ou élément protégé par le PLU.
monument_historiquebooléenTravaux sur un monument historique.
coeur_parc_nationalbooléendocument_urbanismetexteDocument d'urbanisme de la commune.
Valeurs :
plu,carte_communale,rnuzone_urbainebooléenTerrain en zone urbaine du PLU.
surface_taxable_creee_m2nombreTaxe d'aménagement : surface taxable créée, en m².
de 0 à 1 000 000
surface_taxable_existante_m2nombreTaxe d'aménagement : surface taxable existante, en m².
de 0 à 1 000 000
places_stationnement_exterieuresnombreTaxe d'aménagement : places de stationnement extérieures créées.
de 0 à 1 000 000
residence_principalebooléenTaxe d'aménagement : le projet porte sur la résidence principale ou ses annexes (abattement).
affecte_sous_solbooléenRedevance d'archéologie préventive : les travaux affectent le sous-sol.
code_inseetexteCommune du terrain, pour ses taux de taxe d'aménagement ; sans elle, l'estimation reste une fourchette du barème légal.
taux_communal_pctnombreTaux communal de la taxe d'aménagement, en %, s'il est connu (il prime sur celui de la commune).
de 0 à 20
taux_departemental_pctnombreTaux départemental de la taxe d'aménagement, en %, s'il est connu.
de 0 à 5
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/demarche \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"type_travaux":"construction_nouvelle","emprise_au_sol_creee_m2":18,"surface_plancher_creee_m2":18}'Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"statut": "faits_manquants",
"regles_a_jour_le": "2026-09-17",
"projet": {
"type_travaux": "construction_nouvelle",
"libelle": "Construction nouvelle (abri, garage, carport, annexe séparée)",
"faits": [
"Emprise au sol créée : 18 m²",
"Surface de plancher créée : 18 m²"
]
},
"contexte": {
"document": null,
"zone_urbaine": null,
"protections": {
"spr": null,
"abords_monument_historique": null,
"site_classe": null,
"site_inscrit": null,
"reserve_naturelle": false,
"element_protege_plu": null,
"monument_historique": false,
"coeur_parc_national": false
},
"detection": "Sans adresse : la zone du PLU et les servitudes ne sont pas lues. Les protections prises en compte sont celles déclarées dans les paramètres.",
"details": []
},
"faits_manquants": [
"Quelle sera sa hauteur, en mètres ?"
],
"questions": [
{
"fait": "hauteur_m",
"question": "Quelle sera sa hauteur, en mètres ?",
"options": null,
"choix_multiple": false
}
],
"formalite": null,
"formalites_associees": [],
"cerfa": null,
"architecte": null,
"pieces": [],
"delai": null,
"apres_decision": [],
"depot_en_ligne": [],
"taxe_amenagement": null,
"a_confirmer": false,
"notes_a_confirmer": [],
"limites": [
"Information générale établie d'après les textes en vigueur au 17 septembre 2026 : ni un conseil juridique, ni une décision de l'administration.",
"Le résultat dépend des informations que vous avez données ; vous restez responsable de votre demande et de l'exactitude du dossier déposé.",
"Le PLU, une délibération communale ou une protection (monument historique, site, risques) peuvent imposer une autre formalité : faites confirmer par le service urbanisme de votre mairie avant tout dépôt.",
"Pour une réponse qui engage l'administration, demandez un certificat d'urbanisme : les règles sont figées si votre demande est déposée dans les 18 mois.",
"Les croquis générés sont des brouillons indicatifs : vérifiez chaque cote, ils ne remplacent ni un relevé ni des plans établis par un professionnel.",
"Au-delà de 150 m² de surface de plancher après travaux, ou si le demandeur est une société, un architecte est obligatoire pour le permis de construire : Pillr ne produit pas ces plans."
],
"sources": [],
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 17/09/2026.
Réponse
statuttextefaits_manquants : la formalité ou le permis ne peuvent pas être établis sans les réponses de questions.
Valeurs :
conclusion,faits_manquantsregles_a_jour_letexteDate de vérification de la base de règles.
projetobjetAfficher les 3 champsMasquer
type_travauxtexteValeurs :
construction_nouvelle,travaux_existant,transformation_garage,piscine,cloture,mur,aspect_exterieur,pompe_a_chaleur,ravalement,changement_destination,division,demolitionlibelletextefaitsliste de textes
contexteobjetAfficher les 5 champsMasquer
documenttexte ou nullValeurs :
plu,carte_communale,rnuzone_urbainebooléen ou nullprotectionsobjetAfficher les 8 champsMasquer
sprbooléen ou nullabords_monument_historiquebooléen ou nullsite_classebooléen ou nullsite_inscritbooléen ou nullreserve_naturellebooléen ou nullelement_protege_plubooléen ou nullmonument_historiquebooléen ou nullcoeur_parc_nationalbooléen ou null
detectiontextedetailsliste de textes
faits_manquantsliste de textesquestionsliste d'objetsAfficher les 4 champsMasquer
faittexteLe paramètre qui reçoit la réponse.
questiontexteoptionsliste d'objets ou nullAfficher les 2 champsMasquer
libelletextedescriptiontexte ou null
choix_multiplebooléen
formaliteobjet ou nullAfficher les 6 champsMasquer
codetexteValeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirlibelletexteregletextesourcesliste de textesa_confirmerbooléennotesliste de textes
formalites_associeesliste d'objetsAfficher les 4 champsMasquer
regletextesourcesliste de textesa_confirmerbooléennotesliste de textes
cerfaobjet ou nullAfficher les 4 champsMasquer
numerotextelibelletextenotesliste de textessourcesliste de textes
architecteobjet ou nullAfficher les 6 champsMasquer
obligatoirebooléen ou nullnull : ne se prononce pas (faits manquants ou cas hors de la base de règles).
manqueliste de textesregletextesourcesliste de textesa_confirmerbooléennotesliste de textes
piecesliste d'objetsAfficher les 7 champsMasquer
codetexte ou nulllibelletexteconditiontexteexigeetexteValeurs :
oui,selon_le_projetsourcesliste de textesa_confirmerbooléenoperationtexte ou nullL'opération de Pillr Data qui prépare la pièce ; null quand Pillr ne la prépare pas (photos, insertion).
Valeurs :
croquis_projet,coupes_facades,generer_document
delaiobjet ou nullAfficher les 8 champsMasquer
moisnombre ou nullbase_moisnombre ou nulldetailliste de textesprolongations_possiblesliste de textessilencetexteCe que vaut le silence de la mairie au terme du délai.
Valeurs :
acceptation,refusrefus_tacite_siliste de textessourcesliste de textesa_confirmerbooléen
apres_decisionliste d'objetsAfficher les 3 champsMasquer
etapetextesourcesliste de textesa_confirmerbooléen
depot_en_ligneliste d'objetsAfficher les 3 champsMasquer
etapetextesourcesliste de textesa_confirmerbooléen
taxe_amenagementobjet ou nullTaxe d'aménagement estimée, avec la redevance d'archéologie préventive ; null tant que la formalité n'est pas établie.
Afficher les 20 champsMasquer
statuttexteValeurs :
estimee,non_due,hors_calcul,faits_manquantsregletexteannee_valeursentiera_jour_letexteformuletextevaleursliste d'objetsAfficher les 3 champsMasquer
libelletextevaleurtextesourcesliste de textes
assietteliste d'objetsAfficher les 5 champsMasquer
libelletextecalcultexteminnombremaxnombresourcesliste de textes
assiette_minnombreassiette_maxnombrepartsliste d'objetsAfficher les 9 champsMasquer
parttexteValeurs :
communale,departementale,regionalelibelletextetauxtextetaux_minnombretaux_maxnombremontant_minnombremontant_maxnombresourcetextea_confirmerbooléen
total_minnombreTaxe estimée, borne basse, en euros.
total_maxnombreTaxe estimée, borne haute, en euros.
archeologieobjet ou nullAfficher les 6 champsMasquer
statuttexteValeurs :
due,si_sous_sol,non_duetaux_pctnombremontant_minnombremontant_maxnombreregletextesourcesliste de textes
faits_manquantsliste de textesnotesliste de textesa_confirmerbooléendeclarationliste d'objetsAfficher les 2 champsMasquer
etapetextesourcesliste de textes
sourcesliste de texteslimitesliste de textesqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
a_confirmerbooléenVrai si une conclusion est à faire confirmer par le service urbanisme de la mairie.
notes_a_confirmerliste de texteslimitesliste de textessourcesliste de textescreditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Plan de situation, plan de masse et implantation
Essayer en direct/api/v1/urbanisme/croquisLe plan de situation et le plan de masse coté d'un projet (extension, annexe, abri, garage, carport, piscine, terrasse, véranda) sur la parcelle cadastrale et les bâtiments de la BD TOPO de l'IGN, lus en direct, pour une adresse, un identifiant de parcelle ou un point. Les projets se placent contre un côté du bâtiment principal, à une distance d'une limite, par un contour donné, ou automatiquement : trois emplacements notés sur l'ensoleillement au 21 juin et au 21 mars, les distances, le relief et les limites. La réponse donne les emprises et les mesures, les alertes (débord, chevauchement), la formalité établie depuis les projets dessinés, la zone du PLU et les servitudes lues en un point de la parcelle, les règles du règlement déjà lu (reculs, emprise, hauteur) et les vues du plan de situation. Le plan de masse n'est pas dessiné quand un architecte est obligatoire ou que des faits manquent : la réponse le dit, avec les questions. Croquis indicatif, à vérifier avant dépôt.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- croquis_projet
- Bac à sable
- Non
- Cache serveur
- 1 h
- Délai maximal
- 45 s
Paramètres
adressetexteAdresse en texte, numéro compris, géocodée par la Base Adresse Nationale.
de 5 à 200 caractères
code_postaltexteCode postal, pour départager une adresse homonyme (avec adresse).
idutexteIdentifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).
de 14 à 24 caractères
latnombrede -90 à 90
lonnombrede -180 à 180
recul_limites_mnombreImplantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).
de 0 à 50
distance_min_batiments_mnombrede 0 à 50
distance_max_maison_mnombrede 1 à 200
choix_implantationtexteImplantation automatique : l'emplacement retenu, A, B ou C.
Valeurs :
A,B,CformalitetexteFormalité annoncée : jamais crue, comparée à celle que le croquis établit.
Valeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirdemandeurtexteValeurs :
personne_physique,exploitation_agricole,societesurface_plancher_creee_m2nombrede 0 à 1 000 000
surface_plancher_totale_apres_travaux_m2nombrede 0 à 1 000 000
emprise_au_sol_totale_apres_travaux_m2nombrede 0 à 1 000 000
annotationsliste d'objetsÉléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.
60 éléments au plus
Afficher les 12 champsMasquer
typetexteobligatoireValeurs :
arbre,acces,stationnement,reseau,vue_photoposition_wgs84listeetattexteValeurs :
conserve,abattu,plantediametre_mnombrede 0 à 100
azimut_degnombreOrientation, 0 au nord, 90 à l'est.
de -360 à 720
naturetexteValeurs :
vehicule,pietonlargeur_mnombrede 0 à 100
longueur_mnombrede 0 à 100
reseautexteValeurs :
eau,electricite,assainissementtrace_wgs84liste de listes50 éléments au plus
numeroentierde 0 à 1 000
piecetexteValeurs :
proche,lointain
projetsliste d'objetsobligatoireLes projets à placer sur la parcelle.
1 éléments au moins ; 6 éléments au plus
Afficher les 13 champsMasquer
naturetexteobligatoireNature du projet.
Valeurs :
extension,annexe,abri,garage,carport,piscine,terrasse,veranda,autrelibelletexte60 caractères au plus
largeur_mnombreLargeur, le long du côté de référence, en mètres.
de 0,5 à 200
profondeur_mnombreProfondeur, en mètres.
de 0,5 à 200
hauteur_mnombreHauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.
de 0 à 50
ancragetexteaccole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.
Valeurs :
accole_batiment,depuis_limite,auto,librecotetexteCôté visé (bâtiment ou limite) : nord, sud, est, ouest.
Valeurs :
nord,sud,est,ouestdistance_limite_mnombreDistance à la limite, en mètres (ancrage depuis_limite).
de 0 à 500
decalage_mnombreDécalage le long du côté, en mètres.
de -500 à 500
calagetexteValeurs :
centre,extremite_ouest_sud,extremite_est_nordhauteur_couverture_mnombrePiscine : hauteur de la couverture en mètres, 0 si non couverte.
de 0 à 10
demontablebooléenPiscine démontable (hors sol).
contour_wgs84liste de listesAncrage libre : les quatre coins [lon, lat], tels que le croquis les rend.
4 éléments au moins ; 5 éléments au plus
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/croquis \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'Réponse
adresseobjet ou nullAfficher les 4 champsMasquer
libelletextelatnombrelonnombreprecisiontexte
origineobjetOrigine du plan local (mètres, x vers l'est, y vers le nord).
Afficher les 2 champsMasquer
latnombrelonnombre
parcelleobjetAfficher les 9 champsMasquer
idutextesectiontexte ou nullnumerotexte ou nullcommunetexte ou nullcode_inseetexte ou nullcontenance_m2nombre ou nullsurface_calculee_m2nombrecontourliste de liste de liste de nombresssAnneaux de la parcelle, en mètres du plan local.
cotesliste d'objets
batimentsliste d'objetsBâtiments de la BD TOPO sur la parcelle : contour, surface, hauteur, étages, usage, principal.
projetsliste d'objetsProjets placés : contour (plan local) et contour_wgs84, surface, distances aux limites et aux bâtiments, alertes.
projets_non_placesliste d'objetsAfficher les 2 champsMasquer
libelletexteraisontexte
mesuresobjetAfficher les 8 champsMasquer
surface_parcelle_cadastre_m2nombre ou nullsurface_parcelle_calculee_m2nombreemprise_existante_m2nombreemprise_projets_m2nombreemprise_totale_m2nombrepart_emprise_totale_pctnombre ou nullbase_parttexteValeurs :
contenance_cadastrale,surface_calculeedistance_min_limite_projets_mnombre ou null
plan_de_masseobjetAfficher les 6 champsMasquer
echellenombreechelle_usuellebooléencadre_mmobjetAfficher les 2 champsMasquer
largeurnombrehauteurnombre
centreliste de nombresrefusobjet ou nullPlan de masse non dessiné : architecte obligatoire, ou faits manquants pour l'établir.
Afficher les 3 champsMasquer
raisontextea_confirmerbooléenquestionsliste d'objets
formalite_deriveetexte ou nullFormalité établie par la base de règles depuis les projets dessinés ; null : non établie.
Valeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolir
plan_de_situationobjeturbanismeobjet ou nullZone du PLU et servitudes lues en un point intérieur de la parcelle.
urbanisme_indisponibletexte ou nullimplantationobjet ou nullImplantation automatique : trois emplacements notés (soleil, distances, relief, limites).
annotationsliste d'objetscontraintes_pluobjet ou nullRègles du règlement déjà lu (reculs, emprise, hauteur), avec leur source.
constatsliste de textessourcesliste de texteslimitesliste de textesmentiontextegenere_letextequaliteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Coupes, façades et toitures
Essayer en direct/api/v1/urbanisme/coupesLe plan en coupe et le plan des façades et des toitures des projets d'un croquis, à l'échelle : terrain naturel lu en direct sur le RGE ALTI de l'IGN (altitudes NGF), hauteur maximale au-dessus du terrain, distances aux limites, surfaces de déblai et de remblai, toitures (plate, un ou deux pans), ouvertures et matériaux, silhouettes des bâtiments existants accolés. Les projets se décrivent comme pour croquis_projet, avec leurs niveaux, leur toiture et leurs ouvertures. Un fait manquant revient en question et le projet n'est pas dessiné ; si l'altimétrie de l'IGN ne répond pas, rien n'est dessiné ni débité.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- coupes_facades
- Bac à sable
- Non
- Cache serveur
- 1 h
- Délai maximal
- 60 s
Paramètres
adressetexteAdresse en texte, numéro compris, géocodée par la Base Adresse Nationale.
de 5 à 200 caractères
code_postaltexteCode postal, pour départager une adresse homonyme (avec adresse).
idutexteIdentifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).
de 14 à 24 caractères
latnombrede -90 à 90
lonnombrede -180 à 180
recul_limites_mnombreImplantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).
de 0 à 50
distance_min_batiments_mnombrede 0 à 50
distance_max_maison_mnombrede 1 à 200
choix_implantationtexteImplantation automatique : l'emplacement retenu, A, B ou C.
Valeurs :
A,B,CformalitetexteFormalité annoncée : jamais crue, comparée à celle que le croquis établit.
Valeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirdemandeurtexteValeurs :
personne_physique,exploitation_agricole,societesurface_plancher_creee_m2nombrede 0 à 1 000 000
surface_plancher_totale_apres_travaux_m2nombrede 0 à 1 000 000
emprise_au_sol_totale_apres_travaux_m2nombrede 0 à 1 000 000
annotationsliste d'objetsÉléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.
60 éléments au plus
Afficher les 12 champsMasquer
typetexteobligatoireValeurs :
arbre,acces,stationnement,reseau,vue_photoposition_wgs84listeetattexteValeurs :
conserve,abattu,plantediametre_mnombrede 0 à 100
azimut_degnombreOrientation, 0 au nord, 90 à l'est.
de -360 à 720
naturetexteValeurs :
vehicule,pietonlargeur_mnombrede 0 à 100
longueur_mnombrede 0 à 100
reseautexteValeurs :
eau,electricite,assainissementtrace_wgs84liste de listes50 éléments au plus
numeroentierde 0 à 1 000
piecetexteValeurs :
proche,lointain
projetsliste d'objetsobligatoire1 éléments au moins ; 6 éléments au plus
Afficher les 29 champsMasquer
naturetexteobligatoireNature du projet.
Valeurs :
extension,annexe,abri,garage,carport,piscine,terrasse,veranda,autrelibelletexte60 caractères au plus
largeur_mnombreLargeur, le long du côté de référence, en mètres.
de 0,5 à 200
profondeur_mnombreProfondeur, en mètres.
de 0,5 à 200
hauteur_mnombreHauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.
de 0 à 50
ancragetexteaccole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.
Valeurs :
accole_batiment,depuis_limite,auto,librecotetexteCôté visé (bâtiment ou limite) : nord, sud, est, ouest.
Valeurs :
nord,sud,est,ouestdistance_limite_mnombreDistance à la limite, en mètres (ancrage depuis_limite).
de 0 à 500
decalage_mnombreDécalage le long du côté, en mètres.
de -500 à 500
calagetexteValeurs :
centre,extremite_ouest_sud,extremite_est_nordhauteur_couverture_mnombrePiscine : hauteur de la couverture en mètres, 0 si non couverte.
de 0 à 10
demontablebooléenPiscine démontable (hors sol).
contour_wgs84liste de listesAncrage libre : les quatre coins [lon, lat], tels que le croquis les rend.
4 éléments au moins ; 5 éléments au plus
sens_coupetexteValeurs :
perpendiculaire_au_cote,parallele_au_cote,nord_sud,est_ouestfacadestexteValeurs :
principale_et_laterale,toutesprofondeur_bassin_mnombrede 0 à 10
niveau_margelle_mnombrede -10 à 10
largeur_margelle_mnombrede 0 à 5
largeur_plage_mnombrede 0 à 50
niveau_terrasse_mnombrede -10 à 10
niveau_plancher_mnombrede -10 à 10
toituretexteValeurs :
plate,un_pan,deux_panshauteur_murs_mnombrede 0 à 50
hauteur_faitage_mnombrede 0 à 50
pente_toiture_degnombrede 0 à 90
sens_faitagetexteValeurs :
parallele_au_cote,perpendiculaire_au_cotepan_hauttexteValeurs :
cote_reference,cote_opposemateriauxobjetAfficher les 3 champsMasquer
murstexte60 caractères au plus
toituretexte60 caractères au plus
menuiseriestexte60 caractères au plus
ouverturesliste d'objets30 éléments au plus
Afficher les 9 champsMasquer
typetexteobligatoireValeurs :
porte,fenetre,baie,porte_garagefacadetexteobligatoireValeurs :
nord,sud,est,ouestlargeur_mnombrede 0 à 20
hauteur_mnombrede 0 à 10
position_mnombrePosition depuis l'extrémité gauche de la façade vue de l'extérieur, en mètres.
de 0 à 500
allege_mnombreHauteur d'allège depuis le plancher, en mètres.
de 0 à 10
libelletexte40 caractères au plus
materiautexte60 caractères au plus
couleurtexte40 caractères au plus
piecesliste de textesPièces à dessiner : coupe, facades, ou les deux (défaut).
Valeurs :
coupe,facades1 éléments au moins ; 2 éléments au plus
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/coupes \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'Réponse
adresseobjet ou nullAfficher les 4 champsMasquer
libelletextelatnombrelonnombreprecisiontexte
origineobjetAfficher les 2 champsMasquer
latnombrelonnombre
parcelleobjetAfficher les 6 champsMasquer
idutextesectiontexte ou nullnumerotexte ou nullcommunetexte ou nullcode_inseetexte ou nullcontourliste de liste de liste de nombresss
batimentsliste d'objetsprojetsliste d'objetsProjets et leurs altitudes NGF, toitures, ouvertures et mesures.
coupesliste d'objetsPlans en coupe : terrain naturel (RGE ALTI), projet, hauteur maximale au-dessus du terrain, distances aux limites, déblai et remblai.
facadesliste d'objetsFaçades et toitures, ouvertures et matériaux.
feuillesliste d'objetsFeuilles à l'échelle, prêtes à imprimer.
refusobjet ou nullAfficher les 2 champsMasquer
raisontextea_confirmerbooléen
formalite_deriveetexte ou nullValeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirfaits_manquantsliste de textesquestionsliste d'objetsconstatsliste de textesa_confirmerliste de textessourcesliste de texteslimitesliste de textesmentiontextegenere_letextequaliteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Dossier de dépôt
Essayer en direct/api/v1/urbanisme/dossiersLe dossier de dépôt en mairie d'un projet, établi dans l'appel : le croquis de la parcelle (comme croquis_projet), les coupes et façades quand les projets en portent les faits (comme coupes_facades), puis la formalité et le Cerfa retenus, les pièces dans l'ordre du bordereau avec leur code, leur rôle et leur état (prête, à produire par une opération, à fournir par le demandeur), ce qui manque, les alertes du croquis et les données du Cerfa à passer à l'opération cerfa. La réponse est une tâche (202) dont le résultat se lit ensuite. L'archive ZIP du dossier (pièces graphiques à l'échelle, Cerfa, bordereau) se fabrique dans le Hub : par l'API, chaque pièce se produit par son opération.
- Coût
- 200 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- preparer_dossier
- Bac à sable
- Non
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 150 s
Paramètres
adressetexteAdresse en texte, numéro compris, géocodée par la Base Adresse Nationale.
de 5 à 200 caractères
code_postaltexteCode postal, pour départager une adresse homonyme (avec adresse).
idutexteIdentifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).
de 14 à 24 caractères
latnombrede -90 à 90
lonnombrede -180 à 180
recul_limites_mnombreImplantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).
de 0 à 50
distance_min_batiments_mnombrede 0 à 50
distance_max_maison_mnombrede 1 à 200
choix_implantationtexteImplantation automatique : l'emplacement retenu, A, B ou C.
Valeurs :
A,B,CformalitetexteFormalité annoncée : jamais crue, comparée à celle que le croquis établit.
Valeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirdemandeurtexteValeurs :
personne_physique,exploitation_agricole,societesurface_plancher_creee_m2nombrede 0 à 1 000 000
surface_plancher_totale_apres_travaux_m2nombrede 0 à 1 000 000
emprise_au_sol_totale_apres_travaux_m2nombrede 0 à 1 000 000
annotationsliste d'objetsÉléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.
60 éléments au plus
Afficher les 12 champsMasquer
typetexteobligatoireValeurs :
arbre,acces,stationnement,reseau,vue_photoposition_wgs84listeetattexteValeurs :
conserve,abattu,plantediametre_mnombrede 0 à 100
azimut_degnombreOrientation, 0 au nord, 90 à l'est.
de -360 à 720
naturetexteValeurs :
vehicule,pietonlargeur_mnombrede 0 à 100
longueur_mnombrede 0 à 100
reseautexteValeurs :
eau,electricite,assainissementtrace_wgs84liste de listes50 éléments au plus
numeroentierde 0 à 1 000
piecetexteValeurs :
proche,lointain
projetsliste d'objetsobligatoireLes projets, décrits comme pour croquis_projet et, pour les coupes, comme pour coupes_facades.
1 éléments au moins ; 6 éléments au plus
Afficher les 29 champsMasquer
naturetexteobligatoireNature du projet.
Valeurs :
extension,annexe,abri,garage,carport,piscine,terrasse,veranda,autrelibelletexte60 caractères au plus
largeur_mnombreLargeur, le long du côté de référence, en mètres.
de 0,5 à 200
profondeur_mnombreProfondeur, en mètres.
de 0,5 à 200
hauteur_mnombreHauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.
de 0 à 50
ancragetexteaccole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.
Valeurs :
accole_batiment,depuis_limite,auto,librecotetexteCôté visé (bâtiment ou limite) : nord, sud, est, ouest.
Valeurs :
nord,sud,est,ouestdistance_limite_mnombreDistance à la limite, en mètres (ancrage depuis_limite).
de 0 à 500
decalage_mnombreDécalage le long du côté, en mètres.
de -500 à 500
calagetexteValeurs :
centre,extremite_ouest_sud,extremite_est_nordhauteur_couverture_mnombrePiscine : hauteur de la couverture en mètres, 0 si non couverte.
de 0 à 10
demontablebooléenPiscine démontable (hors sol).
contour_wgs84liste de listesAncrage libre : les quatre coins [lon, lat], tels que le croquis les rend.
4 éléments au moins ; 5 éléments au plus
sens_coupetexteValeurs :
perpendiculaire_au_cote,parallele_au_cote,nord_sud,est_ouestfacadestexteValeurs :
principale_et_laterale,toutesprofondeur_bassin_mnombrede 0 à 10
niveau_margelle_mnombrede -10 à 10
largeur_margelle_mnombrede 0 à 5
largeur_plage_mnombrede 0 à 50
niveau_terrasse_mnombrede -10 à 10
niveau_plancher_mnombrede -10 à 10
toituretexteValeurs :
plate,un_pan,deux_panshauteur_murs_mnombrede 0 à 50
hauteur_faitage_mnombrede 0 à 50
pente_toiture_degnombrede 0 à 90
sens_faitagetexteValeurs :
parallele_au_cote,perpendiculaire_au_cotepan_hauttexteValeurs :
cote_reference,cote_opposemateriauxobjetAfficher les 3 champsMasquer
murstexte60 caractères au plus
toituretexte60 caractères au plus
menuiseriestexte60 caractères au plus
ouverturesliste d'objets30 éléments au plus
Afficher les 9 champsMasquer
typetexteobligatoireValeurs :
porte,fenetre,baie,porte_garagefacadetexteobligatoireValeurs :
nord,sud,est,ouestlargeur_mnombrede 0 à 20
hauteur_mnombrede 0 à 10
position_mnombrePosition depuis l'extrémité gauche de la façade vue de l'extérieur, en mètres.
de 0 à 500
allege_mnombreHauteur d'allège depuis le plancher, en mètres.
de 0 à 10
libelletexte40 caractères au plus
materiautexte60 caractères au plus
couleurtexte40 caractères au plus
maison_individuellebooléenPour un permis de construire : le projet porte-t-il sur une maison individuelle ou ses annexes ? Le formulaire et les codes des pièces en dépendent.
coupesbooléenFaux : ne pas dessiner les coupes et façades dans l'appel. Par défaut, elles le sont dès qu'un projet porte ses faits de toiture, de hauteur des murs ou de niveau.
attendreentierSecondes d'attente de la fin de la tâche avant de répondre (60 au plus).
de 0 à 60 ; par défaut 0
webhooktexteURL https appelée à la fin de la tâche, signée (Pillr-Signature).
500 caractères au plus
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/dossiers \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'Réponse
tacheobjetLa tâche asynchrone.
Afficher les 7 champsMasquer
idtexteIdentifiant de la tâche, à passer à l'opération de résultat.
operationtextestatuttexteen_attente, en_cours, terminee (resultat rempli) ou echouee (erreur remplie, crédits rendus).
Valeurs :
en_attente,en_cours,terminee,echoueecree_letextetermine_letexte ou nullexpire_letexteDate au-delà de laquelle le résultat n'est plus conservé.
resultat_urltexteChemin de lecture du résultat (GET).
resultatobjet ou nullLa sortie de l'opération, quand la tâche est terminée ; null sinon.
Afficher les 18 champsMasquer
statuttextepret : la liste des pièces est établie ; sinon le message dit ce qui manque.
Valeurs :
pret,formalite_non_etablie,aucune_formalite,question_maison_individuellemessagetexte ou nullformalitetexte ou nullValeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirlibelle_formalitetexte ou nullformalite_sourcetexte ou nullValeurs :
croquis,demarchecerfaobjet ou nullLe formulaire retenu : il se pré-remplit par l'opération cerfa avec donnees_cerfa.
Afficher les 4 champsMasquer
numerotextelibelletextefichiertexteurl_officielletexte
donnees_cerfaobjetLes faits du dossier pour le Cerfa (terrain, références cadastrales, nature des travaux, emprise) : l'entrée donnees de l'opération cerfa.
cases_a_completerliste d'objetsAfficher les 3 champsMasquer
rubriquetextelibelletexteraisontexte
terrainobjetAfficher les 4 champsMasquer
adressetexte ou nullparcelletextecommunetexte ou nullidutexte
piecesliste d'objetsAfficher les 10 champsMasquer
codetexte ou nullCode du bordereau (DPC1, PCMI2...).
libelletexteroletexteCe que la pièce doit montrer, d'après le bordereau du Cerfa.
etattexteprete : produite par Pillr depuis le croquis ou les coupes ; a_produire : par l'opération dite ; a_fournir : par le demandeur (photos, insertion).
Valeurs :
prete,a_completer,a_produire,a_fournirexigeetexteValeurs :
oui,selon_le_projeta_confirmerbooléencomplementbooléenJoint hors bordereau (vue aérienne).
consignetexte ou nulloperationtexte ou nullL'opération qui produit ou produirait la pièce.
Valeurs :
croquis_projet,coupes_facades,generer_documentfichiertexte ou nullNom du fichier de la pièce dans le dossier du Hub.
manquesliste de textesCe qui manque au dossier, dit en clair.
alertesliste de textesPoints à corriger dans le croquis avant tout dépôt.
notesliste de textesmaison_individuellebooléen ou nullcoupesobjetLes coupes et façades dessinées dans l'appel, ou pourquoi elles ne l'ont pas été.
Afficher les 2 champsMasquer
dessineesbooléenrefustexte ou null
archivetexte ou nullNom de l'archive du dossier dans le Hub (statut pret).
limitesliste de textesgenere_letexte
erreurobjet ou nullPourquoi la tâche a échoué ; null sinon.
Afficher les 2 champsMasquer
codetextedetailtexte
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Résultat : dossier de dépôt
Essayer en direct/api/v1/urbanisme/dossiers/{tache}État et résultat d'une tâche lancée par POST /urbanisme/dossiers (outil preparer_dossier) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- resultat_preparer_dossier
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 5 s
Paramètres
tachetexteobligatoireIdentifiant de la tâche rendu au lancement (tache.id).
attendreentierSecondes d'attente de la fin de la tâche avant de répondre (60 au plus).
de 0 à 60 ; par défaut 0
Exemple d'appel
curl https://pillr.fr/api/v1/urbanisme/dossiers/00000000-0000-4000-8000-000000000001 \
-H "Authorization: Bearer $PILLR_CLE"Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse
tacheobjetLa tâche asynchrone.
Afficher les 7 champsMasquer
idtexteIdentifiant de la tâche, à passer à l'opération de résultat.
operationtextestatuttexteen_attente, en_cours, terminee (resultat rempli) ou echouee (erreur remplie, crédits rendus).
Valeurs :
en_attente,en_cours,terminee,echoueecree_letextetermine_letexte ou nullexpire_letexteDate au-delà de laquelle le résultat n'est plus conservé.
resultat_urltexteChemin de lecture du résultat (GET).
resultatobjet ou nullLa sortie de l'opération, quand la tâche est terminée ; null sinon.
Afficher les 18 champsMasquer
statuttextepret : la liste des pièces est établie ; sinon le message dit ce qui manque.
Valeurs :
pret,formalite_non_etablie,aucune_formalite,question_maison_individuellemessagetexte ou nullformalitetexte ou nullValeurs :
aucune,declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirlibelle_formalitetexte ou nullformalite_sourcetexte ou nullValeurs :
croquis,demarchecerfaobjet ou nullLe formulaire retenu : il se pré-remplit par l'opération cerfa avec donnees_cerfa.
Afficher les 4 champsMasquer
numerotextelibelletextefichiertexteurl_officielletexte
donnees_cerfaobjetLes faits du dossier pour le Cerfa (terrain, références cadastrales, nature des travaux, emprise) : l'entrée donnees de l'opération cerfa.
cases_a_completerliste d'objetsAfficher les 3 champsMasquer
rubriquetextelibelletexteraisontexte
terrainobjetAfficher les 4 champsMasquer
adressetexte ou nullparcelletextecommunetexte ou nullidutexte
piecesliste d'objetsAfficher les 10 champsMasquer
codetexte ou nullCode du bordereau (DPC1, PCMI2...).
libelletexteroletexteCe que la pièce doit montrer, d'après le bordereau du Cerfa.
etattexteprete : produite par Pillr depuis le croquis ou les coupes ; a_produire : par l'opération dite ; a_fournir : par le demandeur (photos, insertion).
Valeurs :
prete,a_completer,a_produire,a_fournirexigeetexteValeurs :
oui,selon_le_projeta_confirmerbooléencomplementbooléenJoint hors bordereau (vue aérienne).
consignetexte ou nulloperationtexte ou nullL'opération qui produit ou produirait la pièce.
Valeurs :
croquis_projet,coupes_facades,generer_documentfichiertexte ou nullNom du fichier de la pièce dans le dossier du Hub.
manquesliste de textesCe qui manque au dossier, dit en clair.
alertesliste de textesPoints à corriger dans le croquis avant tout dépôt.
notesliste de textesmaison_individuellebooléen ou nullcoupesobjetLes coupes et façades dessinées dans l'appel, ou pourquoi elles ne l'ont pas été.
Afficher les 2 champsMasquer
dessineesbooléenrefustexte ou null
archivetexte ou nullNom de l'archive du dossier dans le Hub (statut pret).
limitesliste de textesgenere_letexte
erreurobjet ou nullPourquoi la tâche a échoué ; null sinon.
Afficher les 2 champsMasquer
codetextedetailtexte
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Cerfa d'urbanisme pré-rempli
Essayer en direct/api/v1/urbanisme/cerfa/{numero}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
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- cerfa
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 1 h
- Délai maximal
- 25 s
Paramètres
numerotexteobligatoireNuméro du formulaire : 16702*03, 16703*03, 13406*17, 13409*17, 13405*15, 16297*05 (l'astérisque s'écrit aussi avec un tiret).
donneesobjetobligatoireLes faits du dossier, par clé de la table de correspondance.
Afficher les 21 champsMasquer
terrain.numerotexte1 000 caractères au plus
terrain.voietexte1 000 caractères au plus
terrain.lieudittexte1 000 caractères au plus
terrain.localitetexte1 000 caractères au plus
terrain.code_postaltexte1 000 caractères au plus
parcelle.prefixetexte1 000 caractères au plus
parcelle.sectiontexte1 000 caractères au plus
parcelle.numerotexte1 000 caractères au plus
travaux.descriptiontexte1 000 caractères au plus
annexe.autres_precisiontexte1 000 caractères au plus
parcelle.superficie_m2nombrede 0 à 100 000 000
terrain.superficie_totale_m2nombrede 0 à 100 000 000
emprise.creee_m2nombrede 0 à 100 000 000
travaux.nouvellebooléentravaux.existantebooléentravaux.extensionbooléenannexe.piscinebooléenannexe.garagebooléenannexe.verandabooléenannexe.abribooléenannexe.autresbooléen
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/cerfa/16702-03 \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"donnees":{"terrain.localite":"Rennes","emprise.creee_m2":18}}'Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"numero": "16702*03",
"libelle": "Déclaration préalable (maison individuelle ou autre projet)",
"version_formulaire": "cerfa_16702-03.pdf",
"verifie_le": "2026-09-29",
"cases_remplies": [
{
"rubrique": "3.1",
"libelle": "Adresse du terrain : localité",
"valeur": "Rennes"
},
{
"rubrique": "4.3",
"libelle": "Emprise au sol créée (en m²)",
"valeur": "18"
}
],
"cases_vides": [
{
"rubrique": "3.1",
"libelle": "Adresse du terrain : code postal",
"raison": "non établi par le dossier"
},
{
"rubrique": "3.1",
"libelle": "Références cadastrales : préfixe",
"raison": "non établi par le dossier"
},
{
"rubrique": "3.1",
"libelle": "Références cadastrales : section",
"raison": "non établi par le dossier"
},
{
"rubrique": "3.1",
"libelle": "Références cadastrales : numéro",
"raison": "non établi par le dossier"
},
{
"rubrique": "3.1",
"libelle": "Superficie de la parcelle cadastrale (en m²)",
"raison": "non établi par le dossier"
},
{
"rubrique": "3.1",
"libelle": "Superficie totale du terrain (en m²)",
"raison": "non établi par le dossier"
},
{
"rubrique": "4.1",
"libelle": "Courte description de votre projet ou de vos travaux",
"raison": "non établi par le dossier"
},
{
"rubrique": "1",
"libelle": "Identité du déclarant (particulier ou personne morale)",
"raison": "à compléter par vous"
},
{
"rubrique": "2",
"libelle": "Coordonnées du déclarant (adresse, téléphone, courriel)",
"raison": "à compléter par vous"
},
{
"rubrique": "3.2",
"libelle": "Situation juridique du terrain (certificat d'urbanisme, lotissement, ZAC…)",
"raison": "à compléter par vous"
},
{
"rubrique": "4.2",
"libelle": "Logements créés, leur financement et leur usage, s'il y en a",
"raison": "à compléter par vous"
},
{
"rubrique": "4.3",
"libelle": "Emprise au sol avant travaux et emprise supprimée",
"raison": "à compléter par vous"
},
{
"rubrique": "4.4",
"libelle": "Tableau des surfaces de plancher (existante, créée, supprimée)",
"raison": "à compléter par vous"
},
{
"rubrique": "4.5",
"libelle": "Stationnement",
"raison": "à compléter par vous"
},
{
"rubrique": "5",
"libelle": "Informations pour l'application d'une législation connexe",
"raison": "à compléter par vous"
},
{
"rubrique": "6",
"libelle": "Participation pour voirie et réseaux",
"raison": "à compléter par vous"
},
{
"rubrique": "7",
"libelle": "Engagement du déclarant : lieu, date et signature",
"raison": "à compléter par vous"
},
{
"rubrique": "Bordereau",
"libelle": "Cocher les pièces jointes et reporter leur numéro sur chacune",
"raison": "à compléter par vous"
}
],
"fichier": "cerfa-16702-03-pre-rempli.pdf",
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 29/09/2026.
Réponse
numerotexteValeurs :
16702*03,16703*03,13406*17,13409*17,13405*15,16297*05libelletexteversion_formulairetexteFichier officiel vérifié par Pillr ; une autre version est refusée plutôt que remplie de travers.
verifie_letextecases_rempliesliste d'objetsAfficher les 3 champsMasquer
rubriquetextelibelletextevaleurtexteTexte écrit, ou « coché » pour une case.
cases_videsliste d'objetsCases que le dossier ne sait pas remplir, puis les rubriques jamais remplies (identité, coordonnées, engagement, signature).
Afficher les 3 champsMasquer
rubriquetextelibelletexteraisontexte
fichiertexteNom du fichier PDF servi.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Échéances d'un dossier après dépôt
Essayer en direct/api/v1/urbanisme/echeancesÉchéances datées d'un dossier d'urbanisme à partir de sa date de dépôt : courrier de pièces manquantes, fin du délai d'instruction (de droit commun et majoré), date à partir de laquelle le silence vaut accord ou refus, affichage et recours des tiers, retrait par la mairie, prorogation et fin de validité, recours contre un refus, puis DAACT, déclaration et paiement de la taxe d'aménagement à l'achèvement. Chaque échéance porte sa règle et sa source. La démarche se donne telle que demarche_urbanisme l'a établie, ou se calcule dans l'appel à partir des faits du projet. Les dates se comptent de quantième à quantième ; le récépissé et les courriers de la mairie font foi.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- echeances_depot
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 3 s
Paramètres
date_depottexteobligatoireDate de dépôt du dossier complet en mairie (AAAA-MM-JJ, celle du récépissé).
demarcheobjetLa démarche déjà établie par demarche_urbanisme. Donner demarche ou projet, pas les deux.
Afficher les 9 champsMasquer
type_travauxtexteobligatoireNature des travaux (projet.type_travaux de demarche_urbanisme).
Valeurs :
construction_nouvelle,travaux_existant,transformation_garage,piscine,cloture,mur,aspect_exterieur,pompe_a_chaleur,ravalement,changement_destination,division,demolitionformalitetexteobligatoireFormalité déposée (formalite.code de demarche_urbanisme).
Valeurs :
declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirdelai_base_moisentierobligatoireDélai d'instruction de droit commun, en mois (delai.base_mois).
de 1 à 12
delai_moisentierDélai avec les majorations connues, en mois (delai.mois) ; par défaut, le droit commun.
de 1 à 12
silencetexteobligatoireCe que vaut le silence de la mairie au terme du délai (delai.silence).
Valeurs :
acceptation,refusavis_abfbooléenVrai si un avis défavorable de l'architecte des Bâtiments de France peut faire valoir le silence comme refus (delai.refus_tacite_si non vide).
delai_a_confirmerbooléenDélai à faire confirmer par la mairie (delai.a_confirmer).
taxe_min_eurnombreTaxe d'aménagement estimée, borne basse, en euros.
de 0 à 1 000 000 000
taxe_max_eurnombreTaxe d'aménagement estimée, borne haute, en euros.
de 0 à 1 000 000 000
projetobjetLes faits du projet, comme pour demarche_urbanisme : la démarche est établie dans l'appel.
Afficher les 52 champsMasquer
type_travauxtexteobligatoireNature des travaux. Une annexe séparée est une construction_nouvelle ; une extension ou une véranda accolée, des travaux_existant.
Valeurs :
construction_nouvelle,travaux_existant,transformation_garage,piscine,cloture,mur,aspect_exterieur,pompe_a_chaleur,ravalement,changement_destination,division,demolitionemprise_au_sol_creee_m2nombreEmprise au sol créée, en m² (un carport ou un garage compte même sans surface de plancher).
de 0 à 1 000 000
surface_plancher_creee_m2nombreSurface de plancher créée, ou surface close transformée pour un garage, en m².
de 0 à 1 000 000
hauteur_mnombreHauteur de la construction ou du mur, en mètres.
de 0 à 1 000 000
surface_plancher_existante_m2nombreSurface de plancher du bâtiment existant, en m².
de 0 à 1 000 000
emprise_au_sol_existante_m2nombreEmprise au sol du bâtiment existant, en m².
de 0 à 1 000 000
modifie_aspect_exterieurbooléenmodifie_volumebooléenvisible_espace_publicbooléenbassin_m2nombrePiscine : surface du bassin, en m².
de 0 à 1 000 000
hauteur_couverture_mnombrePiscine : hauteur de la couverture en mètres, 0 si non couverte.
de 0 à 1 000 000
piscine_demontablebooléenduree_installation_moisnombrePiscine démontable : mois d'installation par an.
de 0 à 1 000 000
duree_installation_joursnombrePiscine démontable en espace protégé : jours d'installation par an.
de 0 à 1 000 000
deliberation_communalebooléenLa commune a soumis clôtures ou ravalements à déclaration par délibération.
secteur_cloture_plubooléenClôture dans un secteur délimité par le PLU.
reparation_a_l_identiquebooléenpac_visiblebooléenPompe à chaleur visible depuis l'espace public, la voie ou les autres bâtiments.
date_debut_travauxtexteDate de début des travaux, si elle est passée.
ravalement_change_couleursbooléenchangementtexteValeurs :
destination,sous_destinationtravaux_structure_ou_facadebooléenequipements_communsbooléenDivision : création de voies, espaces ou équipements communs.
date_depottexteDivision : date de dépôt prévue (par défaut, aujourd'hui).
permis_demolir_instituebooléenrestauration_immobilierebooléeninclut_demolitionbooléendemandeurtexteQui dépose la demande (une SCI est une société).
Valeurs :
personne_physique,exploitation_agricole,societemaison_individuellebooléenserre_productionbooléenhauteur_pied_droit_mnombreSerre : hauteur du pied-droit, en mètres.
de 0 à 1 000 000
erp_ou_ighbooléenÉtablissement recevant du public ou immeuble de grande hauteur.
participation_du_publicbooléenevaluation_environnementalebooléensprbooléenTerrain en site patrimonial remarquable.
abords_monument_historiquebooléenTerrain aux abords d'un monument historique.
site_classebooléensite_inscritbooléenreserve_naturellebooléenelement_protege_plubooléenBâtiment ou élément protégé par le PLU.
monument_historiquebooléenTravaux sur un monument historique.
coeur_parc_nationalbooléendocument_urbanismetexteDocument d'urbanisme de la commune.
Valeurs :
plu,carte_communale,rnuzone_urbainebooléenTerrain en zone urbaine du PLU.
surface_taxable_creee_m2nombreTaxe d'aménagement : surface taxable créée, en m².
de 0 à 1 000 000
surface_taxable_existante_m2nombreTaxe d'aménagement : surface taxable existante, en m².
de 0 à 1 000 000
places_stationnement_exterieuresnombreTaxe d'aménagement : places de stationnement extérieures créées.
de 0 à 1 000 000
residence_principalebooléenTaxe d'aménagement : le projet porte sur la résidence principale ou ses annexes (abattement).
affecte_sous_solbooléenRedevance d'archéologie préventive : les travaux affectent le sous-sol.
code_inseetexteCommune du terrain, pour ses taux de taxe d'aménagement ; sans elle, l'estimation reste une fourchette du barème légal.
taux_communal_pctnombreTaux communal de la taxe d'aménagement, en %, s'il est connu (il prime sur celui de la commune).
de 0 à 20
taux_departemental_pctnombreTaux départemental de la taxe d'aménagement, en %, s'il est connu.
de 0 à 5
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/echeances \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"date_depot":"2026-06-01","projet":{"type_travaux":"construction_nouvelle","emprise_au_sol_creee_m2":18}}'Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"statut": "sans_suivi",
"motif": "La formalité ne peut pas être établie sans les faits manquants : demarche_urbanisme pose les questions.",
"faits_manquants": [
"Quelle surface de plancher crée-t-elle, en m² (0 pour un carport ouvert) ?",
"Quelle sera sa hauteur, en mètres ?"
],
"date_depot": "2026-06-01",
"demarche": null,
"echeances": [],
"prochaine": null,
"regles_a_jour_le": "2026-09-29",
"limites": [
"Dates comptées de quantième à quantième à partir de la date de dépôt donnée : le récépissé de dépôt et les courriers de la mairie font foi.",
"Un courrier de pièces manquantes ou de délai majoré, reçu dans le premier mois, décale toutes les dates suivantes.",
"Information générale, ni conseil juridique ni décision de la mairie."
],
"qualite": {
"n": null,
"provenance": null,
"incertitude": null,
"drapeaux": [],
"methode": "Échéances calculées depuis la date de dépôt par les règles du Code de l'urbanisme, de quantième à quantième.",
"donnees_du": "2026-09-29",
"source": "Code de l'urbanisme et fiches de service-public.gouv.fr, règles vérifiées par Pillr"
},
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 29/09/2026.
Réponse
statuttextesans_suivi : la démarche du projet ne se suit pas après dépôt (aucune autorisation, ou faits manquants).
Valeurs :
echeances,sans_suivimotiftexte ou nullPourquoi il n'y a rien à suivre (statut sans_suivi).
faits_manquantsliste de textesProjet : les faits sans lesquels la formalité ne peut pas être établie (voir demarche_urbanisme).
date_depottextedemarcheobjet ou nullLa démarche suivie, telle qu'elle a servi au calcul.
Afficher les 9 champsMasquer
type_travauxtexteValeurs :
construction_nouvelle,travaux_existant,transformation_garage,piscine,cloture,mur,aspect_exterieur,pompe_a_chaleur,ravalement,changement_destination,division,demolitionformalitetexteValeurs :
declaration_prealable,permis_de_construire,permis_d_amenager,permis_de_demolirlibelletexteLibellé court : formalité et nature des travaux.
delai_base_moisnombredelai_moisnombresilencetexteValeurs :
acceptation,refusavis_abfbooléendelai_a_confirmerbooléentaxe_estimeeobjet ou nullAfficher les 2 champsMasquer
minnombremaxnombre
echeancesliste d'objetsLes échéances datées par date croissante, puis celles relatives à l'achèvement.
Afficher les 7 champsMasquer
cletexteIdentifiant stable de l'échéance.
Valeurs :
pieces,fin_instruction,fin_instruction_majoree,silence,affichage,recours_tiers,retrait,prorogation,validite,recours_refus,daact,declaration_taxe,paiement_taxedatetexte ou nullAAAA-MM-JJ ; null pour une échéance relative à l'achèvement des travaux.
quandtexte ou nullPour une échéance sans date : quand elle tombe, en clair.
libelletexteregletexteLa règle qui fixe l'échéance, en clair.
sourcesliste de textesa_confirmerbooléen
prochaineobjet ou nullLa prochaine échéance datée à partir d'aujourd'hui (heure de Paris), ou null.
Afficher les 7 champsMasquer
cletexteIdentifiant stable de l'échéance.
Valeurs :
pieces,fin_instruction,fin_instruction_majoree,silence,affichage,recours_tiers,retrait,prorogation,validite,recours_refus,daact,declaration_taxe,paiement_taxedatetexte ou nullAAAA-MM-JJ ; null pour une échéance relative à l'achèvement des travaux.
quandtexte ou nullPour une échéance sans date : quand elle tombe, en clair.
libelletexteregletexteLa règle qui fixe l'échéance, en clair.
sourcesliste de textesa_confirmerbooléen
regles_a_jour_letexteDate de vérification des règles du suivi.
limitesliste de textesqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Rendu réaliste d'un projet sur la vue aérienne
Essayer en direct/api/v1/urbanisme/rendusUne image réaliste du projet posé à l'échelle sur la photo aérienne de l'IGN : la photo est lue en direct, le dessin exact du projet y est composé, puis un modèle d'image rend le seul projet réaliste, sans rien ajouter ni déplacer. L'image est une illustration indicative : elle ne remplace pas le document graphique d'insertion du dossier. En REST, la réponse est l'image PNG ; en MCP, ses métadonnées, et l'image en ressource. Les rendus sont bornés par heure et par organisation, comme dans le Hub.
- Coût
- 100 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- urbanisme
- Outil MCP
- rendu_aerien
- Bac à sable
- Non
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 90 s
Paramètres
empriselisteobligatoireEmprise de la vue [ouest, sud, est, nord] en degrés, 1500 m de côté au plus (vues.aerienne du plan de situation de croquis_projet).
projetsliste d'objetsobligatoire1 éléments au moins ; 6 éléments au plus
Afficher les 5 champsMasquer
naturetexteobligatoireValeurs :
extension,annexe,abri,garage,carport,piscine,terrasse,veranda,autrecontourliste de listesobligatoireLes quatre coins [lon, lat] du projet (contour_wgs84 de croquis_projet).
4 éléments au moins ; 4 éléments au plus
largeur_mnombreobligatoirede 0,5 à 200
profondeur_mnombreobligatoirede 0,5 à 200
hauteur_mnombrede 0 à 50
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/urbanisme/rendus \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"emprise":[1.0679506,49.4690379,1.0729727,49.4708362],"projets":[{"nature":"abri","contour":[[1.07044043,49.46987927],[1.07047855,49.46988978],[1.07046779,49.46990634],[1.07042968,49.46989582]],"largeur_m":3,"profondeur_m":2,"hauteur_m":2.2}]}'Réponse
mimetextemodeletexteModèle d'image qui a produit le rendu.
genere_letexteavertissementtexteCe que vaut l'image : une illustration indicative.
fichiertextecreditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs