Businesses registered at a building's address

GETapi.baseray.ai/v1/buildings/{building_id}/registered-businesses

The active businesses whose registered office is the building's exact official address, largest first, at most 25; meta.total counts them all. A registered office is never ownership or occupancy.

Requires an API key. How to authenticate.

Path parameters

building_idstring (uuid)required: The building's baseray id, a UUID returned by the other building endpoints.

Response 200

dataarray of RegisteredBusinessrequired

namestringrequired: The business's registered name.
registration_numberstringrequired: Its company registration number (a CUI in Romania, an IČO in Czechia).
countrystringrequired: ISO 3166-1 alpha-2 country of the registration number.
employeesstring or nullrequired: Employees as stated: an exact count (12), a band (10–49) or an open top band (1000 or more); null when not stated.
employees_stated_forstring or nullrequired: When the size was stated: a date, or a financial year such as FY 2024.

metaobjectrequired

totalintegerrequired≥ 0: Every business registered at the address; can exceed the businesses listed.

Errors

400: A parameter is missing, malformed or out of range (invalid_parameter).
401: No API key, or one that does not work: missing_api_key, invalid_api_key, revoked_api_key or expired_api_key.
403: The key may not do this: insufficient_scope, or workspace_access_revoked when the key's creator no longer belongs to its workspace.
404: No building has this id (not_found).
429: rate_limited (the key's per-minute limit) or quota_exceeded (the workspace's daily quota).
503: The building catalogue is unavailable right now (upstream_unavailable); retry after Retry-After seconds.

Every error has the same shape. Error codes.

const response = await fetch("https://api.baseray.ai/v1/buildings/c9eefd1b-8c8d-48fe-8b72-e015374d7720/registered-businesses", { method: "GET", headers: { Authorization: `Bearer ${process.env.BASERAY_API_KEY}` }, }); const result = await response.json();

import os import requests response = requests.get( "https://api.baseray.ai/v1/buildings/c9eefd1b-8c8d-48fe-8b72-e015374d7720/registered-businesses", headers={"Authorization": f"Bearer {os.environ['BASERAY_API_KEY']}"}, timeout=30, ) response.raise_for_status() result = response.json()

{ "data": [ { "name": "Example Business SRL", "registration_number": "00000000", "country": "RO", "employees": "10–49", "employees_stated_for": "FY 2024" } ], "meta": { "total": 1 } }