---
title: "Objets d'urbanisme dans une emprise"
method: GET
path: "/urbanisme/objets"
---

# Objets d'urbanisme dans une emprise

`GET /urbanisme/objets`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/urbanisme/objets`
- Auth: HTTP bearer

Les objets du Géoportail de l'Urbanisme dont l'emprise touche une boîte d'environ 2 km de côté au plus, avec leur géométrie GeoJSON et leurs propriétés brutes : zones, secteurs de carte communale, prescriptions et informations (surfaces, lignes, points), assiettes de servitudes. Liste paginée par curseur, dans l'ordre des couches puis des identifiants. Un objet est retenu quand sa boîte englobante touche l'emprise : sa géométrie peut rester en dehors. Coût : 1 crédit par élément rendu.

## Query parameters

- `bbox` string, required: Emprise « ouest,sud,est,nord » en degrés WGS84, 0.03 degré de longitude et 0.02 degré de latitude au plus (environ 2 km).
- `couches` string: Couches à rendre, séparées par des virgules, parmi : zone_urba, secteur_cc, prescription_surf, prescription_lin, prescription_pct, info_surf, info_lin, info_pct, assiette_sup_s, assiette_sup_l. Par défaut, toutes.
- `limite` integer: Nombre d'éléments par page (1000 au plus).
- `curseur` string: Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

## Response `200`

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

- object
  - `emprise` number[], required: L'emprise lue : ouest, sud, est, nord.
  - `couches` string[], required
  - `donnees` object[], required
    - `couche` 'zone_urba' | 'secteur_cc' | 'prescription_surf' | 'prescription_lin' | 'prescription_pct' | 'info_surf' | 'info_lin' | 'info_pct' | 'assiette_sup_s' | 'assiette_sup_l' | 'acte_sup' | 'doc_urba' | 'doc_urba_com' | 'document' | 'municipality', required
    - `gid` string, required: Identifiant de l'objet dans sa couche.
    - `idurba` string, nullable, required: Identifiant du document d'urbanisme (ex. 35238_PLUI_20251215).
    - `libelle` string, nullable, required
    - `type_code` string, nullable, required
    - `insee` string, nullable, required: Code INSEE de la commune de l'objet, quand la couche le porte.
    - `url_fichier` string, nullable, required
    - `proprietes` object, nullable, required: Propriétés brutes de l'objet, telles que publiées.
    - `geometrie` object, nullable, required: Géométrie GeoJSON en WGS84 (lon, lat).
  - `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.
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `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

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides ; Curseur invalide
- `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)