> ## 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. # Toutes les données d'un bâtiment > Un point d'entrée au choix : `imb`, `parcelle` ou `adresse`. `donnees` filtre les données renvoyées (liste séparée par des virgules : decisionnaires, caracteristiques, fibre, copropriete, proprietaires, gestionnaires, occupants, permis, stationnement, energie, urbanisme). Sans `donnees`, tout est renvoyé. Chaque donnée porte ses sources avec leur date de mise à jour, et une empreinte. Chaque entreprise et chaque dirigeant porte `contact` : le `ref` et les canaux à passer à `POST /v1/contacts`. ## OpenAPI ````yaml /openapi.json get /v1/batiment openapi: 3.1.0 info: title: Urbanora Partner API description: >- API Urbanora. Un bâtiment (IMB, parcelle ou adresse) → toutes ses données, avec leurs sources et leur date de mise à jour ; un contact demandé pour une entreprise ou un dirigeant du bâtiment ; le suivi des bâtiments qui changent. Clé API dans `X-Api-Key`. Erreurs : `{ error: { code, message }, request_id }`. Fair use : 600 appels par minute et 20 000 par jour (Europe/Paris) par clé ; au-delà 429 `RATE_LIMIT_EXCEEDED`, headers `X-RateLimit-*` et `X-RateLimit-Daily-*`. version: 2.0.0 servers: - url: https://partner.urbanora.fr description: Production - url: http://127.0.0.1:8086 description: Développement security: - apiKey: [] tags: - name: batiment description: Données d'un bâtiment - name: contacts description: Demandes de contact - name: suivi description: Bâtiments suivis et changements paths: /v1/batiment: get: tags: - batiment summary: Toutes les données d'un bâtiment description: >- Un point d'entrée au choix : `imb`, `parcelle` ou `adresse`. `donnees` filtre les données renvoyées (liste séparée par des virgules : decisionnaires, caracteristiques, fibre, copropriete, proprietaires, gestionnaires, occupants, permis, stationnement, energie, urbanisme). Sans `donnees`, tout est renvoyé. Chaque donnée porte ses sources avec leur date de mise à jour, et une empreinte. Chaque entreprise et chaque dirigeant porte `contact` : le `ref` et les canaux à passer à `POST /v1/contacts`. parameters: - schema: type: string in: query name: imb required: false description: Code IMB ARCEP. - schema: type: string in: query name: parcelle required: false description: Identifiant de parcelle cadastrale (14 caractères). - schema: type: string in: query name: adresse required: false description: Adresse postale complète. - schema: type: string in: query name: donnees required: false description: >- Données à renvoyer, séparées par des virgules. Valeurs : decisionnaires, caracteristiques, fibre, copropriete, proprietaires, gestionnaires, occupants, permis, stationnement, energie, urbanisme. responses: '200': description: Default Response content: application/json: schema: type: object required: - batiment - donnees - genere_le properties: batiment: type: object description: Identifiants et adresse du bâtiment. Toujours présent. properties: imb: type: - 'null' - string imbs: type: array items: type: string parcelle: type: string parcelles: type: array items: type: string batiments_bdnb: type: array items: type: string adresse: type: - 'null' - string code_postal: type: - 'null' - string commune: type: - 'null' - string code_insee: type: - 'null' - string lon: type: - 'null' - number lat: type: - 'null' - number donnees: type: object description: Une entrée par donnée demandée (toutes par défaut). properties: decisionnaires: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). caracteristiques: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). fibre: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). copropriete: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). proprietaires: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). gestionnaires: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). occupants: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). permis: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). stationnement: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). energie: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). urbanisme: type: object required: - valeur - sources - empreinte properties: valeur: description: La donnée. Objet, liste ou null selon la donnée. sources: type: array items: type: object required: - code - nom - producteur - mise_a_jour - millesime properties: code: type: string nom: type: string producteur: type: string mise_a_jour: type: - 'null' - string description: >- Date de notre dernière mise à jour réussie de la source (AAAA-MM-JJ). millesime: type: - 'null' - string description: >- Millésime ou version du producteur quand elle est lisible (2026_T2, 2025…). empreinte: type: string description: >- Change quand la donnée change (offres de contact exclues). genere_le: type: 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 '503': 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.