Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.1.0
info:
title: 'Immo Spot API'
version: 1.0.0
description: "API d'Immo Spot donnant accès aux données immobilières françaises agrégées depuis les sources officielles (DGFiP, ADEME, Etalab, Géorisques…). Toutes les routes nécessitent une authentification (Bearer token).\n"
servers:
-
url: /api/v1
description: 'Serveur principal'
tags:
-
name: Parcelles
description: 'Informations sur une parcelle cadastrale spécifique'
-
name: 'Zones — Données'
description: 'Données brutes (listes paginées) dans une zone géographique'
-
name: 'Zones — Statistiques'
description: 'Statistiques agrégées par période dans une zone géographique'
-
name: Évaluation
description: "Évaluation de la valeur d'un bien, une méthode par endpoint, sur les moteurs de calcul des calculettes de l'application : par le marché (comparaison), par le revenu (capitalisation, local commercial, DCF), par le coût (sol + construction, coût de remplacement), par le résidu (compte à rebours promoteur, bilan marchand), droits démembrés et viager, prix de bascule louer ou acheter\n"
components:
securitySchemes:
sanctum:
type: http
scheme: bearer
bearerFormat: token
description: 'Token Sanctum obtenu après authentification'
parameters:
EvaluationAdresse:
name: adresse
in: query
required: false
description: "Adresse du bien en texte libre. Facultative : un lieu (`adresse`, `lat`/`lon` ou `parcelle`) sert à proposer des données que l'appelant peut aussi fournir lui-même.\n"
schema:
type: string
minLength: 3
example: '12 rue de Nantes 35000 Rennes'
EvaluationLat:
name: lat
in: query
required: false
description: 'Latitude WGS84 du bien, avec `lon`.'
schema:
type: number
format: float
minimum: -90
maximum: 90
example: 48.1187
EvaluationLon:
name: lon
in: query
required: false
description: 'Longitude WGS84 du bien, avec `lat`.'
schema:
type: number
format: float
minimum: -180
maximum: 180
example: -1.6799
EvaluationParcelle:
name: parcelle
in: query
required: false
description: 'Code INSEE cadastral de la parcelle du bien (14 caractères).'
schema:
type: string
pattern: '^\d{5}\d{3}[A-Z]{1,2}\d{4}$'
example: 35238000AO0742
EvaluationPrimes:
name: primes
in: query
required: false
description: "Primes de risque ajoutées au taux sans risque (OAT à 10 ans du jour), en points de pourcentage, de 0 à 10 chacune. Une prime absente vaut 0. Fourchettes usuelles : liquidité 0,5 à 2 ; attractivité du marché 0 à 1,5 ; état du bien 0 à 2 ; localisation 0 à 1,5 ; gestion 0,5 à 2 ; qualité du locataire 0 à 2.\n"
style: deepObject
explode: true
schema:
type: object
properties:
liquidite:
type: number
description: "Le délai et l'aléa de revente"
example: 1
attractivite:
type: number
description: 'La profondeur du marché local'
example: 0.5
etat:
type: number
description: 'Le risque technique (vétusté, travaux à venir, performance énergétique)'
example: 0
localisation:
type: number
description: "Le risque propre à l'emplacement (nuisances, desserte, risques naturels)"
example: 0
gestion:
type: number
description: 'La charge de gestion (gestion locative, copropriété)'
example: 0.5
qualite_locataire:
type: number
description: "Le risque d'impayé et de vacance"
example: 0
EvaluationBatiments:
name: batiments
in: query
required: true
description: "Les bâtiments (12 au plus), chacun reconstruit à neuf à son coût au m² puis usé composant par composant (gros œuvre 40 %, clos et couvert 20 %, lots techniques 20 %, finitions 20 %, avec leurs durées de vie usuelles). Une rénovation remet un composant à neuf à son année.\n"
style: deepObject
explode: true
schema:
type: array
maxItems: 12
items:
type: object
required:
- surface
- cout_m2
- annee_construction
properties:
libelle:
type: string
example: Maison
surface:
type: number
description: 'Surface construite, en m²'
example: 120
cout_m2:
type: number
description: 'Coût de construction à neuf, hors honoraires, en € par m²'
example: 1800
annee_construction:
type: integer
example: 1985
renovations:
type: object
description: 'Année de la dernière rénovation de chaque composant'
properties:
gros_oeuvre:
type: integer
example: 1985
clos_couvert:
type: integer
example: 2005
lots_techniques:
type: integer
example: 2012
finitions:
type: integer
example: 2018
EvaluationHonoraires:
name: honoraires
in: query
required: false
description: "Honoraires et frais de maîtrise d'œuvre, en % du coût de construction (15 par défaut)."
schema:
type: number
minimum: 0
maximum: 100
example: 15
EvaluationAmenagements:
name: amenagements_exterieurs
in: query
required: false
description: 'Aménagements extérieurs (clôtures, voirie, réseaux), en euros (0 par défaut).'
schema:
type: number
minimum: 0
example: 15000
EvaluationObsolescence:
name: obsolescence
in: query
required: false
description: "Obsolescence fonctionnelle ou économique, en % de la valeur usée (0 par défaut) : un bâti qui ne répond plus à l'usage, même en bon état.\n"
schema:
type: number
minimum: 0
maximum: 90
example: 0
EvaluationAnnee:
name: annee
in: query
required: false
description: "Année de l'évaluation, pour l'âge des composants (l'année en cours par défaut)."
schema:
type: integer
example: 2026
ZoneType:
name: zoneType
in: path
required: true
description: 'Type de zone géographique'
schema:
type: string
enum:
- commune
- departement
- iris
- secteur
example: commune
ZoneId:
name: zoneId
in: path
required: true
description: "Identifiant de la zone selon son type : code INSEE commune (ex. 35238), code INSEE département (ex. 35 ou 2A), code IRIS à 9 chiffres (ex. 352380000), ou UUID de secteur personnalisé.\n"
schema:
type: string
example: '35238'
PerPage:
name: per_page
in: query
required: false
description: 'Nombre de résultats par page (défaut 20, max 20)'
schema:
type: integer
minimum: 1
maximum: 20
default: 20
example: 20
Page:
name: page
in: query
required: false
description: 'Numéro de page à récupérer (défaut 1)'
schema:
type: integer
minimum: 1
default: 1
example: 1
Has:
name: has
in: query
required: false
description: "Conditions que la parcelle doit satisfaire, une par jeu de données interrogé. Elles se cumulent en **ET logique** : seules sont retournées les parcelles qui portent à la fois des enregistrements de chaque condition.\n\nChaque condition prend un `dataset` et ses `filters`, dans le même vocabulaire que l'endpoint dédié à ce jeu — `zone_dvf`, `zone_dpe`, `zone_audits_energetiques`, `zone_proprietaires`, `zone_permis`, `zone_fonds_commerce`. L'énumération exacte des jeux et de leurs filtres est rappelée en fin de description, générée depuis le registre.\n\n`dataset` peut nommer **plusieurs jeux**, et la condition est alors satisfaite par l'un **ou** l'autre — les mêmes `filters` étant posés sur chacun, ils doivent appartenir au vocabulaire de tous. C'est la seule façon de poser une question à deux sources voisines : `?has[0][dataset][0]=dpe&has[0][dataset][1]=audits-energetiques&has[0][filters][etiquette_min]=F` retient les parcelles portant un DPE **ou** un audit classé F ou G, là où deux conditions séparées auraient exigé les deux à la fois.\n\nExemple — parcelles portant à la fois des ventes de T3 en appartement et des DPE classés F ou G : `?has[0][dataset]=dvf&has[0][filters][typologies]=appartement&has[0][filters][pieces_min]=3&has[0][filters][pieces_max]=3&has[1][dataset]=dpe&has[1][filters][etiquette_min]=F`\n\n**Ce que la réponse affirme, et ce qu'elle n'affirme pas.** Elle constate que la même parcelle porte les enregistrements de chaque condition, et les joint en pièces justificatives. Elle **n'établit aucune correspondance entre eux** : dans l'exemple ci-dessus, rien ne dit que le T3 vendu est le logement classé F. Chaque condition indique sa méthode de rattachement à la parcelle (`declare_source` quand la source fournit la référence cadastrale, `jointure_spatiale` quand elle est déduite du point géocodé), ainsi que le nombre d'enregistrements qui n'ont pas pu être rattachés et n'apparaissent donc dans aucune parcelle.\n\nJeux croisables et filtres acceptés :\n- `dvf` — rattachement declare_source. Filtres : type_vente, typologies, date_start, date_end, pieces, pieces_min, pieces_max, montant_min, montant_max, surface_bati_min, surface_bati_max, surface_terrain_min, surface_terrain_max, prix_m2_min, prix_m2_max, prix_m2_terrain_min, prix_m2_terrain_max, surface_maison_min, surface_maison_max, surface_appartement_min, surface_appartement_max, surface_activite_min, surface_activite_max, logements_min, logements_max, lots_min, lots_max, parcelles_min, parcelles_max, dependance, nature_culture.\n- `dpe` — rattachement jointure_spatiale. Filtres : type, type_batiment, chauffage, etiquette, etiquette_min, etiquette_max, etiquette_ges, etiquette_ges_min, etiquette_ges_max, date_start, date_end, annee_construction_min, annee_construction_max, surface_habitable_min, surface_habitable_max.\n- `audits-energetiques` — rattachement jointure_spatiale. Filtres : etiquette, etiquette_min, etiquette_max, etiquette_ges, etiquette_ges_min, etiquette_ges_max, date_start, date_end, annee_construction_min, annee_construction_max, surface_habitable_min, surface_habitable_max.\n- `proprietaires` — rattachement declare_source. Filtres : categorie_juridique, forme_juridique_code, droit, groupe, type_bien, nature_culture, nature_culture_code.\n- `permis` — rattachement declare_source. Filtres : type, statut, demandeur, date_acceptation_min, date_acceptation_max, annee_depot_min, annee_depot_max, indicateurs, piscine, extension, surelevation, nivsupp, garage, veranda, abri_jardin, autre_annexe.\n- `fonds-commerce` — rattachement declare_source. Filtres : date_min, date_max, montant_min, montant_max, familles.\n- `etablissements` — rattachement jointure_spatiale. Filtres : etat, section_activite, activite, effectifs, date_creation_min, date_creation_max, siege, sans_domiciliations, sans_entrepreneurs_individuels."
schema:
type: array
items:
type: object
required:
- dataset
properties:
dataset:
oneOf:
-
type: string
-
type: array
items: { type: string }
description: "Jeu de données interrogé, ou liste de jeux dont l'un suffit à satisfaire la condition.\n"
enum:
- dvf
- dpe
- audits-energetiques
- proprietaires
- permis
- fonds-commerce
- etablissements
filters:
type: object
description: "Filtres du jeu, dans le vocabulaire de son endpoint dédié (ex. {\"etiquette_min\": \"F\"} pour le DPE).\n"
Parcelle:
name: parcelle
in: query
required: false
description: "Critères portant sur **la parcelle elle-même**, et non sur ce qu'elle porte (`has`) ni sur l'endroit où elle se trouve (`intersect`). Aucun jeu de données n'est interrogé : ces critères se lisent sur les colonnes de la parcelle.\n\nIls se suffisent à eux-mêmes — `has` n'est pas obligatoire — ce qui permet de poser des questions sur le foncier nu, qu'aucun jeu rattaché ne saurait exprimer : l'absence de bâtiment n'est pas un enregistrement.\n\nExemple — les terrains non bâtis de plus de 500 m² à Rennes : `/v1/commune/35238/parcelles?parcelle[bati][]=non_batie&parcelle[surface_min]=500`\n\nExemple — les parcelles bâties portant un DPE classé F ou G, en combinant les deux familles : `/v1/commune/35238/parcelles?parcelle[bati][]=batie&has[0][dataset]=dpe&has[0][filters][etiquette_min]=F`\n\n**L'état bâti** croise le parcellaire cadastral avec le bâti de la BDNB (empreintes IGN de la BD Topo). Les deux levés étant indépendants, un bâtiment déborde régulièrement sur la parcelle voisine : deux seuils écartent ces débords, l'un absolu (10 m² de surface bâtie) et l'autre relatif (2 % de la surface de la parcelle). D'où trois états et non deux — `bati_leger` réunit les parcelles portant une construction réelle mais marginale, tel un hangar au milieu d'une parcelle agricole.\n\nUne parcelle dont le croisement n'a pas encore été calculé n'appartient à **aucun** des trois états et sort donc du résultat, quel que soit l'état demandé : elle n'est pas déclarée non bâtie par défaut.\n\nFiltres acceptés :\n- `surface_min, surface_max` — Surface de la parcelle.\n- `bati` — État bâti de la parcelle. Valeurs : non_batie, bati_leger, batie."
schema:
type: object
properties:
bati:
type: array
description: "États bâtis retenus, qui s'unissent en OU. `non_batie` (aucun bâtiment, ou seulement le débord de la parcelle voisine), `bati_leger` (une construction réelle mais marginale au regard de la surface), `batie`.\n"
items:
type: string
enum:
- non_batie
- bati_leger
- batie
example:
- non_batie
surface_min:
type: number
description: 'Surface minimale de la parcelle (contenance cadastrale), en m².'
example: 500
surface_max:
type: number
description: 'Surface maximale de la parcelle (contenance cadastrale), en m².'
example: 2000
Intersect:
name: intersect
in: query
required: false
description: "Restreint les résultats aux entités situées **à l'intérieur d'une ou plusieurs zones supplémentaires**, en plus de la zone principale ({zoneType}/{zoneId}).\n\nChaque entrée décrit une zone par son `type` et, optionnellement, des `filters` ciblant un sous-ensemble de cette couche. Les zones se cumulent en **ET logique** : un résultat doit intersecter la zone principale ET chacune des zones listées.\n\nExemple — les copropriétés de Rennes situées en zone UA1 du PLU : `/v1/commune/35238/coproprietes?intersect[0][type]=urbanisme-zonage&intersect[0][filters][libelle]=UA1`\n\nExemple — les DPE d'une commune à la fois en zone de TVA réduite et en aléa argile fort : `/v1/commune/35238/dpe?intersect[0][type]=tva-reduite&intersect[1][type]=risques-argile&intersect[1][filters][niveau]=3`\n\nUn `type` sans `filters` prend toute la couche (ex. `tva-reduite` seul = zones et bandes d'extension 300 m confondues). Maximum 5 zones par requête.\n\nUn filtre accepte aussi une **liste** de valeurs, qui s'y unissent en OU — à l'inverse des zones, qui se cumulent en ET. Exemple — les parcelles en zone urbanisée **ou** à urbaniser : `intersect[0][type]=urbanisme-zonage&intersect[0][filters][typezone][0]=U&intersect[0][filters][typezone][1]=AUc`\n\n`exclude=true` retourne une entrée : le résultat doit alors se trouver **hors** de cette zone, sans la toucher en aucun point. Exemple — les parcelles hors de tout périmètre de protection des monuments historiques : `intersect[0][type]=urbanisme-perimetre-protection&intersect[0][exclude]=true`\n\nUne exclusion ne dit pas qu'une contrainte est absente, seulement qu'aucune donnée connue ne la signale : sur une couche incomplète, elle retient aussi ce qui n'a pas encore été versé.\n\nTypes disponibles et filtres acceptés (valeurs détaillées via `zone_types`) :\n- `commune` — Commune. Filtres : id, insee, nom.\n- `departement` — Département. Filtres : id, insee.\n- `iris` — IRIS. Filtres : id, insee.\n- `secteur` — Secteur personnalisé. Filtres : id.\n- `urbanisme-zonage` — Zonage d'urbanisme (PLU/PLUi/CC). Filtres : id, libelle, typezone, type, partition.\n- `urbanisme-document` — Périmètre de document d'urbanisme. Filtres : id, du_type.\n- `urbanisme-sup` — Servitude d'utilité publique (SUP). Filtres : id, suptype.\n- `urbanisme-thd` — Zonage très haut débit (THD). Filtres : id, categorie_fthd.\n- `urbanisme-anru` — Quartier ANRU. Filtres : id, programme, categorie.\n- `urbanisme-qad` — Quartier ancien dégradé (QAD). Filtres : id, source.\n- `urbanisme-site-patrimonial` — Site patrimonial remarquable (SPR). Filtres : id, appelation.\n- `urbanisme-perimetre-protection` — Périmètre de protection des monuments historiques. Filtres : id, type.\n- `qpv-2024` — Quartier prioritaire de la ville (millésime 2024). Filtres : id, code, label, had.\n- `qpv-2015` — Quartier prioritaire de la ville (millésime 2015). Filtres : id, code, label, had.\n- `tva-reduite` — Zone de TVA réduite à 5,5 %. Filtres : id, type, source_type, convention_renouvellement_urbain.\n- `denormandie` — Commune éligible au dispositif Denormandie. Filtres : id, arrete, ort.\n- `malraux` — Zone éligible au dispositif Malraux. Filtres : id, classe.\n- `zone-tendue` — Commune en zone tendue. Filtres : id, categorie.\n- `lli` — Commune éligible au logement locatif intermédiaire. Filtres : id, ort, mixite_acquise.\n- `friches` — Friche (Cartofriches). Filtres : id, site_statut, site_type.\n- `risques-inondation` — Zone inondable. Filtres : id, typ_inond, scenario.\n- `risques-basol` — Site et sol pollué (ex BASOL). Filtres : id, statut_instruction.\n- `risques-argile` — Retrait-gonflement des argiles. Filtres : id, niveau, alea.\n- `urbanisme-hauteur` — Hauteur. Filtres : id, stypepsc.\n- `urbanisme-emprise-au-sol` — Emprise au sol. Filtres : id, stypepsc.\n- `urbanisme-volumetrie` — Volumétrie. Filtres : id, stypepsc.\n- `urbanisme-implantation` — Règles d'implantation des constructions. Filtres : id, stypepsc.\n- `urbanisme-emplacement-reserve` — Emplacement réservé. Filtres : id, stypepsc.\n- `urbanisme-zone-agricole-naturelle` — Constructions en zone A ou N. Filtres : id, stypepsc.\n- `urbanisme-oap` — Orientation d'aménagement et de programmation (OAP). Filtres : id, stypepsc.\n- `urbanisme-ebc` — Espace boisé classé (EBC). Filtres : id, stypepsc.\n- `urbanisme-secteur-mixite-sociale` — Secteur de mixité sociale. Filtres : id, stypepsc.\n- `urbanisme-diversite-commerciale` — Diversité commerciale. Filtres : id, stypepsc.\n- `urbanisme-stationnement` — Stationnement. Filtres : id, stypepsc.\n- `urbanisme-limitation-constructibilite` — Limitation de la constructibilité. Filtres : id, stypepsc.\n- `urbanisme-projet-ppr` — Projet de plan de prévention des risques. Filtres : id, stypeinf.\n- `urbanisme-assainissement` — Zonage d'assainissement. Filtres : id, stypeinf.\n- `urbanisme-dpu` — Droit de préemption urbain (DPU). Filtres : id, stypeinf.\n- `urbanisme-bruit-infrastructures` — Bruit des infrastructures de transport. Filtres : id, stypeinf.\n- `urbanisme-rlp` — Règlement local de publicité (RLP). Filtres : id, stypeinf.\n- `urbanisme-zac` — Zone d'aménagement concerté (ZAC). Filtres : id, stypeinf.\n- `urbanisme-preemption-commerciale` — Droit de préemption commercial. Filtres : id, stypeinf.\n- `urbanisme-sursis-a-statuer` — Sursis à statuer. Filtres : id, stypeinf.\n- `urbanisme-pup` — Projet urbain partenarial (PUP). Filtres : id, stypeinf.\n- `urbanisme-zad` — Zone d'aménagement différé (ZAD). Filtres : id, stypeinf.\n- `urbanisme-bande-recul` — Bande de recul (axes à grande circulation). Filtres : id, stypeinf."
schema:
type: array
items:
type: object
required:
- type
properties:
type:
type: string
description: 'Type de zone combinable. Appeler `zone_types` pour le catalogue complet.'
enum:
- commune
- departement
- iris
- secteur
- urbanisme-zonage
- urbanisme-document
- urbanisme-sup
- urbanisme-thd
- urbanisme-anru
- urbanisme-qad
- urbanisme-site-patrimonial
- urbanisme-perimetre-protection
- qpv-2024
- qpv-2015
- tva-reduite
- denormandie
- malraux
- zone-tendue
- lli
- friches
- risques-inondation
- risques-basol
- risques-argile
- urbanisme-hauteur
- urbanisme-emprise-au-sol
- urbanisme-volumetrie
- urbanisme-implantation
- urbanisme-emplacement-reserve
- urbanisme-zone-agricole-naturelle
- urbanisme-oap
- urbanisme-ebc
- urbanisme-secteur-mixite-sociale
- urbanisme-diversite-commerciale
- urbanisme-stationnement
- urbanisme-limitation-constructibilite
- urbanisme-projet-ppr
- urbanisme-assainissement
- urbanisme-dpu
- urbanisme-bruit-infrastructures
- urbanisme-rlp
- urbanisme-zac
- urbanisme-preemption-commerciale
- urbanisme-sursis-a-statuer
- urbanisme-pup
- urbanisme-zad
- urbanisme-bande-recul
filters:
type: object
description: "Filtres restreignant la couche à un sous-ensemble, sous forme clé/valeur (ex. {\"libelle\": \"UA1\"}). Les filtres disponibles dépendent du `type` : voir le catalogue ci-dessus ou l'endpoint `zone_types`. Tous les types acceptent `id` pour cibler un polygone précis.\n"
exclude:
type: boolean
default: false
description: "Retourne l'entrée : le résultat doit se trouver hors de cette zone, sans la toucher en aucun point. Les `filters` restent lus, et désignent alors ce dont il faut sortir.\n"
schemas:
Parcelle:
type: object
description: "Parcelle cadastrale française identifiée par son code INSEE cadastral. Source : Etalab (cadastre ouvert).\n"
properties:
insee:
type: string
description: 'Code INSEE cadastral unique de la parcelle (ex. 75056000BX0042)'
example: 35238000BE0329
region_insee:
type: string
nullable: true
description: 'Code INSEE de la région'
example: '53'
departement_insee:
type: string
description: 'Code INSEE du département (2 ou 3 caractères)'
example: '35'
commune_insee:
type: string
description: 'Code INSEE de la commune'
example: '35238'
section_insee:
type: string
description: 'Code INSEE de la section cadastrale'
example: 35238000BE
prefix:
type: string
description: 'Préfixe de section (généralement "000")'
example: '000'
section:
type: string
description: 'Lettre(s) de section'
example: BE
numero:
type: string
description: 'Numéro de parcelle dans la section'
example: '0329'
contenance:
type: number
format: float
description: 'Surface cadastrale déclarée en m² (contenance au plan)'
example: 1273.0
arpente:
type: boolean
description: 'Indique si la parcelle a été arpentée (mesurée précisément)'
example: false
surface:
type: number
format: float
description: 'Surface géométrique calculée en m² à partir de la géométrie réelle'
example: 1272.7
adresse:
type: string
nullable: true
description: 'Adresse postale la plus probable, obtenue par géocodage inverse du centroïde'
example: '12 Rue de la Paix, 35238 Saint-Grégoire'
adresses:
type: array
description: "Liste des adresses candidates issues du géocodage inverse (jusqu'à 5 résultats)"
items:
type: string
example:
- '12 Rue de la Paix, 35238 Saint-Grégoire'
- '14 Rue de la Paix, 35238 Saint-Grégoire'
TaxeAmenagement:
type: object
description: "Taux de taxe d'aménagement pour un niveau administratif donné"
properties:
zone_application:
type: string
description: "Niveau d'application : Communale, Départementale ou Régionale"
example: Communale
taux:
type: number
format: float
nullable: true
description: 'Taux en pourcentage'
example: 5.0
date_effet:
type: string
format: date
nullable: true
description: "Date d'entrée en vigueur du taux"
example: '2024-01-01'
commune_insee:
type: string
nullable: true
description: 'Code INSEE de la commune concernée'
example: '35238'
parcelle_insee:
type: string
nullable: true
description: 'Code INSEE cadastral de la parcelle (pour les taux majorés)'
example: 35238000BE0329
Copropriete:
type: object
description: "Copropriété issue du Registre National des Copropriétés (RNC) géré par l'ANAH.\n"
properties:
immatriculation:
type: string
nullable: true
description: "Numéro d'immatriculation au RNC"
example: AA2099810
nom:
type: string
nullable: true
description: 'Nom de la copropriété'
example: '0149 - SDC 20 RUE GRAMONT'
adresse:
type: string
nullable: true
description: 'Adresse complète de la copropriété'
example: '20 r de gramont 75002 Paris'
periode_construction:
type: string
nullable: true
description: "Période de construction. Valeurs possibles : AVANT_1949, DE_1949_A_1960, DE_1961_A_1974, DE_1975_A_1993, DE_1994_A_2000, DE_2001_A_2010, APRES_2010, NON_CONNUE.\n"
example: AVANT_1949
lots_total:
type: integer
nullable: true
description: 'Nombre total de lots'
example: 39
lots_habitation:
type: integer
nullable: true
description: "Nombre de lots à usage d'habitation"
example: 18
lots_stationnement:
type: integer
nullable: true
description: 'Nombre de lots à usage de stationnement'
example: 0
lots_bureaux_commerces:
type: integer
nullable: true
description: 'Nombre de lots à usage de bureaux ou commerces'
example: 5
syndic_type:
type: string
nullable: true
enum:
- professionnel
- benevole
description: "Type de syndic. Vide quand la copropriété n'en a pas déclaré, ce qui est le cas de 42 % des lignes.\n"
example: professionnel
syndic_nom:
type: string
nullable: true
description: 'Nom du syndic'
example: 'PICKERING REAL ESTATE'
syndic_siret:
type: string
nullable: true
description: 'SIRET du syndic'
example: '84258950900012'
syndic_cooperatif:
type: boolean
nullable: true
description: 'Indique si le syndicat est coopératif'
example: null
syndic_principal:
type: boolean
nullable: true
description: "Indique s'il s'agit du syndic principal"
example: true
residence_service:
type: boolean
nullable: true
description: 'Indique si la copropriété est une résidence-service'
example: null
nombre_asl:
type: integer
nullable: true
description: "Nombre d'ASL (Associations Syndicales Libres) rattachées"
example: 0
nombre_aful:
type: integer
nullable: true
description: "Nombre d'AFUL (Associations Foncières Urbaines Libres) rattachées"
example: 0
nombre_unions:
type: integer
nullable: true
description: "Nombre d'unions de syndicats rattachées"
example: 0
date_immatriculation:
type: string
format: date
nullable: true
description: "Date d'immatriculation au RNC (YYYY-MM-DD)"
example: '2017-08-18'
date_reglement:
type: string
format: date
nullable: true
description: 'Date du règlement de copropriété (YYYY-MM-DD)'
example: '1952-03-14'
date_mandat_fin:
type: string
format: date
nullable: true
description: 'Date de fin du mandat du syndic (YYYY-MM-DD)'
example: null
mandat_status:
type: string
nullable: true
enum:
- en_cours
- aucun
- expire_sans_successeur
- expire_avec_successeur
description: "État du mandat du syndic. `expire_sans_successeur` dit une copropriété laissée sans administrateur.\n"
example: en_cours
commune_insee:
type: string
nullable: true
description: 'Code INSEE de la commune'
example: '75002'
departement_insee:
type: string
nullable: true
description: 'Code INSEE du département'
example: '75'
Batiment:
type: object
description: "Bâtiment issu de la Base de Données Nationale des Bâtiments (BDNB — CSTB), à l'échelle du \"groupe de bâtiments\" (unité de la BDNB regroupant les constructions contiguës d'une même opération). L'entrée agrège déjà les données DPE, copropriété, risques, urbanisme et DVF croisées nationalement par le producteur — pas besoin de recouper vous-même parcelle, DPE et copropriété.\n"
properties:
batiment_groupe_id:
type: string
nullable: true
description: 'Identifiant BDNB du groupe de bâtiments'
example: bdnb-bg-1G5X-YFV3-ZKPP
departement_insee:
type: string
nullable: true
example: '35'
commune_insee:
type: string
nullable: true
example: '35238'
iris_insee:
type: string
nullable: true
example: '352380101'
surface_m2:
type: integer
nullable: true
description: 'Surface au sol du groupe de bâtiments en m²'
example: 245
hauteur
# --- truncated at 32 KB (390 KB total) ---
# Full source: https://artifacts.apis.io/immo-spot-com/openapi/_original/immo-spot-com-api-openapi.yml