Immo Spot API API

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

GitHub OpenAPI

Operations 45

GET /parcelle Trouver une parcelle cadastrale par adresse ou coordonnées GPS #
GET /parcelle/{insee} Récupérer les informations cadastrales #
GET /parcelle/{insee}/dvf Mutations immobilières (DVF) #
GET /parcelle/{insee}/dpe Diagnostics de Performance Énergétique (DPE) #
GET /parcelle/{insee}/audits-energetiques Audits énergétiques #
GET /parcelle/{insee}/loyers Loyers de référence au m² #
GET /parcelle/{insee}/proprietaires Propriétaires #
GET /parcelle/{insee}/batiments Bâtiments (BDNB, enrichis DPE/rénovation/copropriété/risques/DVF...) #
GET /parcelle/{insee}/coproprietes Copropriétés #
GET /parcelle/{insee}/fonds-commerce Cessions de fonds de commerce #
GET /parcelle/{insee}/etablissements Établissements occupant la parcelle #
GET /parcelle/{insee}/permis Autorisations d'urbanisme #
GET /parcelle/{insee}/urbanisme-documents Documents d'urbanisme #
GET /parcelle/{insee}/urbanisme-zones Zones d'urbanisme et de patrimoine #
GET /parcelle/{insee}/taxe-amenagement Taxe d'aménagement #
GET /parcelle/{insee}/erp Rapport État des Risques et Pollutions (ERP) #
GET /parcelle/{insee}/risques Risques naturels et industriels applicables #
GET /evaluation/comparaison Estimer un logement par comparaison #
GET /evaluation/capitalisation Évaluer un bien loué par capitalisation de son revenu #
GET /evaluation/commerce Évaluer les murs d'un local commercial #
GET /evaluation/dcf Évaluer un bien par actualisation de ses flux (DCF) #
GET /evaluation/sol-construction Évaluer un bien bâti par son terrain et sa construction #
GET /evaluation/remplacement Évaluer un bien par son coût de remplacement #
GET /evaluation/promoteur Évaluer un terrain à bâtir par le compte à rebours promoteur #
GET /evaluation/marchand Évaluer le prix d'achat maximal d'un marchand de biens #
GET /evaluation/demembrement Évaluer un usufruit, une nue-propriété ou un viager #
GET /evaluation/bascule Calculer le prix au-delà duquel louer coûte moins cher qu'acheter #
GET /zones Trouver le découpage administratif à un emplacement #
GET /zone-types Catalogue des zones combinables #
GET /{zoneType}/{zoneId}/parcelles Parcelles croisant plusieurs jeux de données #
GET /{zoneType}/{zoneId}/dvf Mutations immobilières (DVF) #
GET /{zoneType}/{zoneId}/dvf/stats Statistiques DVF par période #
GET /{zoneType}/{zoneId}/dpe DPE #
GET /{zoneType}/{zoneId}/dpe/stats Statistiques DPE par période #
GET /{zoneType}/{zoneId}/audits-energetiques Audits énergétiques #
GET /{zoneType}/{zoneId}/friches Friches industrielles et urbaines #
GET /{zoneType}/{zoneId}/qpv-2024 Quartiers prioritaires de la politique de la ville (2024) #
GET /{zoneType}/{zoneId}/qpv-2015 Quartiers prioritaires de la politique de la ville (2015) #
GET /{zoneType}/{zoneId}/batiments Bâtiments (BDNB, enrichis DPE/rénovation/copropriété/risques/DVF...) #
GET /{zoneType}/{zoneId}/permis Autorisations d'urbanisme #
GET /{zoneType}/{zoneId}/fonds-commerce Cessions de fonds de commerce #
GET /{zoneType}/{zoneId}/etablissements Établissements #
GET /{zoneType}/{zoneId}/coproprietes Copropriétés #
GET /{zoneType}/{zoneId}/insee Statistiques territoriales INSEE #
GET /{zoneType}/{zoneId}/proprietaires Propriétaires #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/immo-spot-com:immo-spot-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

immo-spot-com-api-openapi.yml Raw ↑
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