Skip to main content
GET
Get a building
The response answers 403 when the building does not exist, when it is not available to your service account, and when the api product is not enabled for it. The API does not say which, so a building id cannot be guessed. A building you just created answers 403 until the api product is enabled. See Create a building.
The counts (areasCount, devicesCount, connectorsCount, systemsCount, and pointsCount) and stats.devices come from the building data in KODE OS. They are 0 for a building that has no data yet. List buildings leaves stats empty.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

buildingId
string
required

Building identifier from List buildings.

Response

The building.

_id
string
organizationId
string
createdAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

updatedAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

name
string
identifier
string
area
object
yearBuild
integer<int32>
primaryFunction
string
tags
string[]
address
object
picture
string
tz
string
areasCount
integer<int32>
devicesCount
integer<int32>
connectorsCount
integer<int32>
systemsCount
integer<int32>
pointsCount
integer<int32>
stats
object
baseTemp
number<double>
published
boolean
ossEnabled
boolean
climateZone
object
region
string
brand
string
zone
string
district
string
phoneNumber
string
site
object
products
object[]