---
title: "One building's preview image"
method: GET
path: "/public/buildings/{building_id}/preview.png"
tags: ["Public building pages"]
---

# One building's preview image

`GET /public/buildings/{building_id}/preview.png`

## Request

- Base URL: `https://api.baseray.ai/v1`
- URL: `https://api.baseray.ai/v1/public/buildings/{building_id}/preview.png`
- Auth: none required

A 1200×630 PNG preview of one building that has a public page, for link previews and social cards. Any other building answers 404, as its page does.

## Path parameters

- `building_id` string, uuid, required

## Response `200`

The preview image.

## 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)
