---
title: "A place's building statistics"
method: GET
path: "/public/places/{country}/{slug}/stats"
tags: ["Public building pages"]
---

# A place's building statistics

`GET /public/places/{country}/{slug}/stats`

## Request

- Base URL: `https://api.baseray.ai/v1`
- URL: `https://api.baseray.ai/v1/public/places/{country}/{slug}/stats`
- Auth: none required

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

## Path parameters

- `country` 'cz' | 'dk' | 'ro', required
- `slug` string, required

## Response `200`

OK

- PublicPlaceStatistics: One place's building statistics.
  - `name` string, required
  - `county` string, nullable, required
  - `buildings` integer, required
  - `addressed` integer, required: Buildings with an address from an address record.
  - `built` object, required
    - `known` integer, required: Buildings whose construction year or era is known.
    - `byEra` object[], required
      - `era` string, required
      - `count` integer, required
    - `before1978Share` number, nullable, required: Share (0–1) of buildings with a known year built before 1978.
  - `floors` object, required
    - `known` integer, required: Buildings whose floors are known.
    - `histogram` object[], required
      - `floors` string, required: A floor count or a range, e.g. `1` or `10+`.
      - `count` integer, required
    - `blocks4plus` integer, required: Buildings of four or more floors.
  - `tallest` object[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `height` number, nullable, required: Height in metres; null where the building is ranked by its floors because no height is measured.
    - `label` string, required
  - `solar` object, nullable, required: Rooftop solar counts; null where no roof in the place has been checked.
    - `checkedRoofs` integer, required: Roofs checked for solar panels.
    - `withPanels` integer, required: Of them, roofs with panels.
    - `imageryYears` integer[], required: Years of the photos the roofs were checked on.
  - `roofAreaTotalM2` number, required: Total roof area in m².
  - `registeredCompanies` integer, required: Companies with their registered office in the place.
  - `updatedAt` string, date, required

## Other responses

- `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.

---

[API](https://skmtc.dev/baseray/apis/baseray-api.md) · [All operations](https://skmtc.dev/baseray/apis/baseray-api/llms.txt) · [OpenAPI document](https://skmtc.dev/baseray/apis/baseray-api/revisions/2dc2808717f7?raw)