Skip to content
Sign in Sign up

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. A business its register protects from direct marketing is marked advertising_protected: its data may not be used for direct marketing.

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

OK

dataarray of RegisteredBusinessrequired
namestringrequired
The business's registered name.
registration_numberstringrequired
Its company registration number (a CUI in Romania, an IČO in Czechia, a CVR number in Denmark).
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.
advertising_protectedboolean or nullrequired
True where the business's register protects it from direct marketing (in Denmark, reklamebeskyttelse under CVR-loven § 19: "Reklamebeskyttet – må ikke bruges til direkte markedsføring"): its data may not be used for direct marketing and may be passed on only marked as protected. False where the register states it unprotected; null where the register states nothing of the kind.
natural_personboolean or nullrequired
True where the register's legal form makes the business a person's: a sole proprietorship or personally owned small business, or the estate of a deceased person. Its name is then usually its owner's. Null where the register states no legal form.
legal_formobject or any or nullrequired
The legal form as the register codes and words it; null where it states none.
codestringrequired
The register's code for the form.
labelstringrequired
The form in the register's own words.
person_kindpersonally_owned | estate or nullrequired
For a person's business: personally_owned ("Personligt ejet virksomhed": a sole proprietorship or personally owned small business) or estate ("Dødsbo": the estate of a deceased person). Null for any other business.
ceased_onstring (date) or nullrequired
The day a person's business ceased, given only for one still served after it ceased ("Ophørt"); null while it is active.
metaobjectrequired
totalintegerrequired≥ 0
Every business registered at the address; can exceed the businesses listed.
sourcesarray of stringrequired
The credits the registers of the businesses listed require wherever their data are passed on, such as "Indeholder data fra Det Centrale Virksomhedsregister (CVR), Erhvervsstyrelsen, via Datafordeleren (CC BY 4.0)". Empty when none is required.

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.
402
insufficient_credits: the answer's buildings need more credits than the workspace has left this month. Nothing was returned or charged.
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.