> ## Documentation Index > Fetch the complete documentation index at: https://docs.urbanora.fr/llms.txt > Use this file to discover all available pages before exploring further. # Qualifier un immeuble (fibre, copro, syndic, occupants) > Un appel, une réponse : IMB, fibre, bâtiment, copropriété/syndic, propriétaires, régies, décisionnaires, occupants, fraîcheur. Entrée au choix : `imb_code` | `parcelle_id` | `address` | `lon`+`lat` (un seul mode). Scope `buildings`. Pas de propriétaires personnes physiques, pas de DPE / urbanisme / DVF. ## OpenAPI ````yaml /openapi.json get /v1/buildings/qualify openapi: 3.1.0 info: title: Urbanora Partner API description: >- API partenaire Urbanora — façade HTTP authentifiée par clé API (`X-Api-Key`). Erreurs : `{ error: { code, message }, request_id }`. Rate-limit : 60 req/min (burst 20) ; 429 `RATE_LIMIT_EXCEEDED` + headers `X-RateLimit-*`. version: 1.0.0 servers: - url: https://partner.urbanora.fr description: Production - url: http://127.0.0.1:8086 description: Développement security: - apiKey: [] tags: - name: meta description: Sources et usage - name: buildings description: Qualification d'immeuble - name: imb description: IMB / fibre - name: copros description: Copropriétés - name: syndics description: Syndics - name: search description: Recherche et géocodage - name: zones description: Territoire - name: contacts description: Contacts paths: /v1/buildings/qualify: get: tags: - buildings summary: Qualifier un immeuble (fibre, copro, syndic, occupants) description: >- Un appel, une réponse : IMB, fibre, bâtiment, copropriété/syndic, propriétaires, régies, décisionnaires, occupants, fraîcheur. Entrée au choix : `imb_code` | `parcelle_id` | `address` | `lon`+`lat` (un seul mode). Scope `buildings`. Pas de propriétaires personnes physiques, pas de DPE / urbanisme / DVF. parameters: - schema: type: string example: IMB/13055/X/0042 in: query name: imb_code required: false description: Code IMB ARCEP, ex. IMB/13055/X/0042 - schema: type: string example: 13055000AB0123 in: query name: parcelle_id required: false description: Référence cadastrale - schema: type: string example: 12 rue de la République, Marseille in: query name: address required: false description: Adresse postale (géocodée BAN) - schema: type: string example: '5.3698' in: query name: lon required: false description: Longitude WGS84 (avec lat) - schema: type: string example: '43.2965' in: query name: lat required: false description: Latitude WGS84 (avec lon) responses: '200': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - imb - fibre - batiment - copropriete - proprietaires - gestionnaires - decisionnaires - occupants - fraicheur properties: imb: type: object additionalProperties: false required: - code - adresse - nb_locaux - batiment_id - parcelle_id properties: code: type: - 'null' - string adresse: type: - 'null' - string nb_locaux: type: - 'null' - integer batiment_id: type: - 'null' - string description: Identifiant bâtiment BDNB (`batiment_groupe_id`). parcelle_id: type: - 'null' - string fibre: type: object additionalProperties: false required: - statut - operateurs - date_raccordable - fermeture_cuivre - millesime_arcep properties: statut: type: - 'null' - string operateurs: type: array items: type: string date_raccordable: type: - 'null' - string fermeture_cuivre: type: - 'null' - object additionalProperties: false properties: lot: type: - 'null' - string date_cible: type: - 'null' - string millesime_arcep: type: - 'null' - string batiment: type: object additionalProperties: false required: - annee_construction - nb_logements - nb_etages - usage_principal properties: annee_construction: type: - 'null' - integer nb_logements: type: - 'null' - integer nb_etages: type: - 'null' - integer usage_principal: type: - 'null' - string copropriete: type: object additionalProperties: false required: - immatriculee - numero_immatriculation - nb_lots_total - nb_lots_habitation - date_reglement - syndic properties: immatriculee: type: boolean numero_immatriculation: type: - 'null' - string nb_lots_total: type: - 'null' - integer nb_lots_habitation: type: - 'null' - integer date_reglement: type: - 'null' - string syndic: type: - 'null' - object additionalProperties: false properties: type: type: - 'null' - string raison_sociale: type: - 'null' - string siret: type: - 'null' - string siren: type: - 'null' - string adresse: type: - 'null' - string date_derniere_maj_registre: type: - 'null' - string proprietaires: type: array description: >- Propriétaires personnes morales (cadastre MAJIC), hors régies. Jamais de personne physique. items: type: object additionalProperties: false required: - type - denomination - siren - nb_locaux - probable properties: type: type: string enum: - personne_morale denomination: type: - 'null' - string siren: type: - 'null' - string nb_locaux: type: - 'null' - integer probable: type: boolean description: '`true` : déduit des occupants, absent du cadastre.' gestionnaires: type: array description: >- Régies : personnes morales détectées comme gestionnaires de l'immeuble. items: type: object additionalProperties: false required: - denomination - siren - confiance properties: denomination: type: - 'null' - string siren: type: - 'null' - string confiance: type: - 'null' - string enum: - faible - moyenne - elevee - confirmee - null decisionnaires: type: array description: >- Dirigeants (RNE) du syndic, des régies et des propriétaires, dans cet ordre. Une personne physique n'apparaît qu'à ce titre. items: type: object additionalProperties: false required: - pour - raison_sociale - siren - nom - prenom - qualite - personne - siren_dirigeant properties: pour: type: string enum: - syndic - regie - proprietaire raison_sociale: type: - 'null' - string description: Personne morale dirigée siren: type: - 'null' - string description: SIREN de la personne morale dirigée nom: type: - 'null' - string prenom: type: - 'null' - string qualite: type: - 'null' - string personne: type: string enum: - physique - morale siren_dirigeant: type: - 'null' - string description: >- Dirigeant personne morale : son SIREN, pour remonter à ses dirigeants. occupants: type: array items: type: object additionalProperties: false required: - siret - denomination - naf - effectif properties: siret: type: - 'null' - string denomination: type: - 'null' - string naf: type: - 'null' - string effectif: type: - 'null' - string fraicheur: type: object additionalProperties: false required: - arcep - rnic - rne - majic - bdnb properties: arcep: type: - 'null' - string rnic: type: - 'null' - string rne: type: - 'null' - string majic: type: - 'null' - string bdnb: type: - 'null' - string '400': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string request_id: type: string '401': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string request_id: type: string '403': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string request_id: type: string '404': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string request_id: type: string '429': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string request_id: type: string security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: X-Api-Key description: >- Clé API partenaire (`upk_live_…` / `upk_test_…`). Alias MCP : `Authorization: Bearer upk_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.