Skip to content

Sign in Sign up

Buildings with a public page

GETapi.baseray.ai/v1/public/buildings

A country's buildings that have a public page, in a stable order, for sitemaps. Follow nextCursor until it is null.

Query parameters

countrycz | dk | rorequired: cz (Czechia) or ro (Romania).
cursorstring: The nextCursor of the previous page; omit for the first page.
limitinteger1–50000: Buildings per page, at most 50,000.

Response 200

OK

itemsarray of objectrequired

idstring (uuid)required
slugstringrequired
updatedAtstring (date)required

nextCursorstring or nullrequired

Pass as cursor for the next page; null on the last one.

totalintegerrequired

Buildings with a public page in the country.

Errors

400: A query parameter is missing or malformed (invalid_parameter).
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.

Request

curl "https://api.baseray.ai/v1/public/buildings?country=cz&limit=50000"

const response = await fetch("https://api.baseray.ai/v1/public/buildings?country=cz&limit=50000", {
  method: "GET",
});
const result = await response.json();

import os
import requests

response = requests.get(
    "https://api.baseray.ai/v1/public/buildings",
    params={"country": "cz", "limit": "50000"},
    timeout=30,
)
response.raise_for_status()
result = response.json()

Response 200

{
  "items": [
    {
      "id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
      "slug": "praha-vinohradska-12",
      "updatedAt": "2026-10-01"
    }
  ],
  "nextCursor": "eyJrIjoiYzllZSJ9",
  "total": 2210000
}