---
title: "Copropriétés du Registre national"
method: GET
path: "/coproprietes"
---

# Copropriétés du Registre national

`GET /coproprietes`

## Request

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

Les copropriétés immatriculées au Registre national des copropriétés, par numéro d'immatriculation, par la clé BAN d'une adresse (immatriculation portée par le DPE, sinon parcelle commune, sinon position à 30 m au plus), ou par filtres (commune, code postal, ou point et rayon, puis nombre de lots, type de syndic, copropriété aidée) : adresse et nom d'usage, lots (total, habitation, stationnement), période de construction, syndic professionnel nommé (raison sociale, SIRET, APE), mandat en cours et fin du dernier mandat, parcelles, dispositifs publics et aide. Le représentant d'un syndic bénévole n'est jamais servi. L'agrégat de la commune accompagne la liste. Coût : 1 crédit par élément rendu.

## Query parameters

- `insee` string: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
- `cp` string: Code postal.
- `lat` number: Latitude en degrés décimaux (WGS 84).
- `lon` number: Longitude en degrés décimaux (WGS 84).
- `rayon_m` integer: Rayon autour du point, en mètres.
- `lots_min` integer: Nombre total de lots, au moins.
- `lots_max` integer: Nombre total de lots, au plus.
- `type_syndic` 'professionnel' | 'benevole' | 'non_renseigne'
- `aidee` union: true : seulement les copropriétés aidées ; false : seulement les autres.
  - boolean
  - 'true' | 'false'
- `limite` integer: Nombre d'éléments par page (50 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
  - `donnees` object[], required
    - `numero` string, required
    - `immatriculee_le` string, nullable, required
    - `maj_le` string, nullable, required
    - `nom_usage` string, nullable, required
    - `adresse` string, nullable, required
    - `code_postal` string, nullable, required
    - `insee` string, nullable, required
    - `commune` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `distance_m` number, nullable, required: Distance au point ou à l'adresse demandés, en mètres.
    - `lots_total` integer, nullable, required
    - `lots_habitation` integer, nullable, required
    - `lots_habitation_bureaux_commerces` integer, nullable, required
    - `lots_stationnement` integer, nullable, required
    - `periode_construction` string, nullable, required
    - `reglement_le` string, nullable, required
    - `syndic` object, required
      - `type` string, nullable, required
      - `raison_sociale` string, nullable, required: Raison sociale d'un syndic professionnel ; null pour un syndic bénévole ou coopératif, dont le représentant n'est jamais servi.
      - `siret` string, nullable, required
      - `ape` string, nullable, required
      - `mandat_en_cours` string, nullable, required
      - `fin_mandat` string, nullable, required
    - `parcelles` string[], required
    - `dispositifs` string[], required: Dispositifs publics : acv (Action cœur de ville), pvd (Petites villes de demain), qpv (quartier prioritaire), plan_sauvegarde.
    - `aidee` boolean, nullable, required
    - `qp` object, nullable, required: Quartier prioritaire de la politique de la ville (2024).
      - `code` string, nullable, required
      - `nom` string, nullable, required
    - `residence_service` boolean, nullable, required
    - `syndicat_cooperatif` boolean, nullable, required
    - `rattachement` object, nullable, required: Par une clé BAN : comment la copropriété est rattachée à l'adresse (immatriculation portée par le DPE, parcelle commune, position à 30 m au plus).
      - `methode` 'dpe' | 'parcelle' | 'position', required
      - `distance_m` number, nullable, 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.
  - `commune` object, nullable, required: L'agrégat de la commune, quand la recherche porte sur une seule commune.
    - `insee` string, required
    - `copros` integer, nullable, required
    - `lots_total` integer, nullable, required
    - `lots_habitation` integer, nullable, required
    - `sans_mandat` integer, nullable, required
    - `aidees` integer, nullable, required
    - `plan_sauvegarde` integer, nullable, required
    - `syndic_benevole` integer, nullable, required
    - `donnees_du` string, nullable, required
  - `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)