> ## Documentation Index > Fetch the complete documentation index at: https://docs.gabin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get the condominium of a building > Registered condominium of the building (RNIC): lots, construction period, type of manager and the professional manager (syndic) when it is a legal entity. A volunteer manager is an individual and is never named. ## OpenAPI ````yaml https://api.gabin.ai/v1/openapi.json get /v1/buildings/{id}/condominium openapi: 3.1.0 info: title: Gabin API version: 1.0.0 description: >- French company and real-estate data for builders: companies (SIRENE, RNE), establishments, officers, annual accounts, buildings (BDNB), parcels, addresses, zones, multi-criteria search, vector tiles, reference data. Guides: https://docs.gabin.ai. **Authentication.** Every endpoint except `/v1/health` and `/v1/openapi.json` requires `Authorization: Bearer `: an API key (`gab_live_…`, created at https://gabin.ai/compte/api) or an OAuth access token (`gat_…`, MCP connectors). **Limits (free plan).** 60 weighted requests per minute and 5,000 units per UTC day per account. A request weighs 1 unless its endpoint states otherwise. Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `X-Quota-Remaining` and `X-Request-Id`. **Responses.** Success: `{ "data": …, "meta": { … } }`. Lists are paginated by an opaque cursor (`meta.page.next_cursor`, up to 100 per page and 10,000 results per query). Errors: `{ "error": { "code", "message", "docs_url" } }`. Dates are ISO 8601, amounts in euros, areas in m², coordinates WGS84 `[lon, lat]`. **Data rules.** Companies under SIRENE partial diffusion are returned without the person's name, street address, position or building. Officers come from public registers only (name, first names, month and year of birth, mandates), without contact details. No contact data is exposed. contact: name: Gabin url: https://gabin.ai servers: - url: https://api.gabin.ai security: - bearerAuth: [] tags: - name: Companies description: >- Companies (SIRENE legal units): search with filters, profile, establishments, officers, annual accounts. - name: Establishments description: Establishments (SIRENE), by SIRET. - name: Officers description: >- Company officers from public registers (RNE): search by name, mandates, relationships. - name: Reference data description: >- Values accepted by the filters: NAF activities, legal form families, headcount ranges. - name: Account description: 'The account behind the API key: plan, limits, remaining quota.' - name: Meta description: Service status and OpenAPI document. No authentication. - name: Buildings description: >- French buildings (BDNB): profile, linked companies, sections (energy, transactions, owners, condominium, parcels, parking, permits, fiber, planning, market) and geographic search. - name: Parcels description: 'Cadastral parcels: boundary, area, buildings.' - name: Addresses description: >- Address geocoding (Base Adresse Nationale) with the BDNB building at the address, and named places. - name: Zones description: >- Cities, districts (merged IRIS), departments, and market figures of a zone (prices, rents, demography, income). - name: Search description: >- Multi-criteria search on buildings or companies in a zone: a catalog of fields, AND conditions, OR groups. - name: Tiles description: Vector tiles (Mapbox Vector Tile) of the gabin.ai map layers. paths: /v1/buildings/{id}/condominium: get: tags: - Buildings summary: Get the condominium of a building description: >- Registered condominium of the building (RNIC): lots, construction period, type of manager and the professional manager (syndic) when it is a legal entity. A volunteer manager is an individual and is never named. operationId: getBuildingCondominium parameters: - name: id in: path required: true description: >- BDNB building id (`batiment_groupe_id`). Example: "bdnb-bg-CJ69-HW8G-PTTG". schema: type: string maxLength: 40 pattern: ^bdnb-[a-z]{2,4}-[A-Za-z0-9]{4}(-[A-Za-z0-9]{4})*$ responses: '200': description: OK headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Quota-Remaining: $ref: '#/components/headers/X-Quota-Remaining' content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/BuildingCondominium' meta: type: object description: Empty for a single resource. '400': description: INVALID headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' examples: INVALID: value: error: code: INVALID message: 'limit: Too big: expected number to be <=100' docs_url: https://docs.gabin.ai/errors#invalid '401': description: UNAUTHENTICATED headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' examples: UNAUTHENTICATED: value: error: code: UNAUTHENTICATED message: Invalid or revoked API key. docs_url: https://docs.gabin.ai/errors#unauthenticated '404': description: NOT_FOUND headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' content: application/json: schema: $ref: '#/components/schemas/Error' examples: NOT_FOUND: value: error: code: NOT_FOUND message: No company with SIREN 999999999. docs_url: https://docs.gabin.ai/errors#not_found '429': description: RATE_LIMITED, QUOTA_EXCEEDED headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' examples: RATE_LIMITED: value: error: code: RATE_LIMITED message: >- Rate limit reached (60 weighted requests per minute). Retry in 12 s. docs_url: https://docs.gabin.ai/errors#rate_limited QUOTA_EXCEEDED: value: error: code: QUOTA_EXCEEDED message: >- Daily quota reached (5000 units per UTC day). It resets at 00:00 UTC. docs_url: https://docs.gabin.ai/errors#quota_exceeded '503': description: TIMEOUT, BUSY headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Error' examples: TIMEOUT: value: error: code: TIMEOUT message: The query took too long. Narrow it down and retry. docs_url: https://docs.gabin.ai/errors#timeout BUSY: value: error: code: BUSY message: >- The API is serving too many database requests right now. Retry in 1 s. docs_url: https://docs.gabin.ai/errors#busy components: headers: X-Request-Id: description: Unique id of the request; quote it when contacting support. schema: type: string X-RateLimit-Limit: description: Weighted requests allowed per minute for the account. schema: type: integer X-RateLimit-Remaining: description: Weighted requests left in the current minute. schema: type: integer X-RateLimit-Reset: description: Seconds until the per-minute window resets. schema: type: integer X-Quota-Remaining: description: Units left in the daily quota (UTC day). schema: type: integer Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: BuildingCondominium: type: object properties: condominium: anyOf: - type: object properties: registration_number: type: string description: Number in the national register (RNIC). name: description: Usual name. type: - string - 'null' address: description: Address. type: - string - 'null' lots: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Total lots. housing_lots: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Housing lots. parking_lots: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parking lots. construction_period: description: Construction period, in French. type: - string - 'null' manager_type: description: 'Type of manager: "professionnel", "bénévole", "coopératif".' type: - string - 'null' mandate: description: Current mandate, as declared. type: - string - 'null' manager: anyOf: - type: object properties: siret: type: string description: SIRET of the professional manager (syndic). company: $ref: '#/components/schemas/CompanySummary' source: type: string enum: - rnic - bdnb_historique description: >- `rnic`: register; `bdnb_historique`: historical BDNB fallback. required: - siret - company - source - type: 'null' description: >- Professional manager; null for a volunteer manager (a person, not named) or none. volunteer_manager: type: boolean description: >- True when a volunteer manager exists: an individual, never named. required: - registration_number - name - address - lots - housing_lots - parking_lots - construction_period - manager_type - mandate - manager - volunteer_manager - type: 'null' description: Null when the building is not a registered condominium. required: - condominium description: Condominium of the building (RNIC register). Error: type: object properties: error: type: object properties: code: type: string enum: - UNAUTHENTICATED - FORBIDDEN - NOT_FOUND - INVALID - ZONE_REQUIRED - PAGINATION_LIMIT - RATE_LIMITED - QUOTA_EXCEEDED - TIMEOUT - BUSY - INTERNAL description: Stable machine-readable code. message: type: string description: Human-readable explanation, in English. docs_url: type: string description: Documentation page for this error code. required: - code - message - docs_url required: - error description: Error body. The HTTP status matches `error.code`. CompanySummary: type: object properties: siren: type: string description: 'SIREN: 9 digits. Example: 552100554.' name: type: string description: >- Registered name; first and last name for a sole proprietorship. Neutral label under partial diffusion ("Entrepreneur individuel"). Example: "Atelier Thermique du Rhône". naf_code: type: string description: 'NAF rev. 2 sub-class of the company. Example: "43.29A".' naf_label: type: string description: 'Label of the NAF code, in French. Example: "Travaux d''isolation".' sector: description: Gabin sector slug of the NAF code, null outside sectors. type: - string - 'null' created_on: description: Creation date (YYYY-MM-DD). type: - string - 'null' active: type: boolean description: False when the company has ceased (SIRENE state C). partial_diffusion: type: boolean description: >- True when the company is under SIRENE partial diffusion: no name of the person, address limited to the city, no position, no building, no officers. gabin_url: type: string description: Page of the company on gabin.ai. legal_form: description: >- INSEE label of the legal form, in French. Example: "SAS, société par actions simplifiée". type: - string - 'null' headcount_range: type: string enum: - '11' - '12' - '21' - '22' - '31' - '32' - '41' - '42' - '51' - '52' - '53' - NN - '00' - '01' - '02' - '03' description: >- INSEE headcount range code. "NN": not reported. See GET /v1/headcount-ranges. headquarters: type: object properties: address: type: string description: Street of the registered office; empty under partial diffusion. postal_code: description: 'Postal code. Example: "69100".' type: - string - 'null' city: type: string description: 'City. Example: "Villeurbanne".' required: - address - postal_code - city latest_revenue: description: >- Latest reported revenue, present only when results are ranked by revenue (no `q`, `insee`, `iris` or `department`). Otherwise see GET /v1/companies/{siren}/financials. In euros; null when not reported. type: - number - 'null' latest_revenue_year_end: description: Fiscal year end (YYYY-MM-DD) of `latest_revenue`. type: - string - 'null' required: - siren - name - naf_code - naf_label - sector - created_on - active - partial_diffusion - gabin_url - legal_form - headcount_range - headquarters - latest_revenue - latest_revenue_year_end description: A company in a list. securitySchemes: bearerAuth: type: http scheme: bearer description: API key `gab_live_…` or OAuth access token `gat_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.