Skip to content
Sign in Sign up

A place's building statistics

GETapi.baseray.ai/v1/public/places/{country}/{slug}/stats

How many buildings a place has, how old and how tall they are, its tallest buildings and rooftop solar counts.

Path parameters

countrycz | dk | rorequired
cz (Czechia) or ro (Romania).
slugstringrequired
The place's slug, from /public/places.

Response 200

OK

namestringrequired
countystring or nullrequired
buildingsintegerrequired
addressedintegerrequired
Buildings with an address from an address record.
builtobjectrequired
knownintegerrequired
Buildings whose construction year or era is known.
byEraarray of objectrequired
erastringrequired
countintegerrequired
before1978Sharenumber or nullrequired
Share (0–1) of buildings with a known year built before 1978.
floorsobjectrequired
knownintegerrequired
Buildings whose floors are known.
histogramarray of objectrequired
floorsstringrequired
A floor count or a range, e.g. 1 or 10+.
countintegerrequired
blocks4plusintegerrequired
Buildings of four or more floors.
tallestarray of objectrequired
idstring (uuid)required
slugstringrequired
heightnumber or nullrequired
Height in metres; null where the building is ranked by its floors because no height is measured.
labelstringrequired
solarobject or any or nullrequired
Rooftop solar counts; null where no roof in the place has been checked.
checkedRoofsintegerrequired
Roofs checked for solar panels.
withPanelsintegerrequired
Of them, roofs with panels.
imageryYearsarray of integerrequired
Years of the photos the roofs were checked on.
roofAreaTotalM2numberrequired
Total roof area in m².
registeredCompaniesintegerrequired
Companies with their registered office in the place.
updatedAtstring (date)required

Errors

404
No such page (not_found).
429
Too many requests from this address in a minute (rate_limited); retry after Retry-After seconds.
503
The building catalogue is unavailable right now (unavailable); retry after Retry-After seconds.

Every error has the same shape. Error codes.