---
title: "A bought report"
method: GET
path: "/public/building-reports/{token}"
tags: ["Building reports"]
---

# A bought report

`GET /public/building-reports/{token}`

## Request

- Base URL: `https://api.baseray.ai/v1`
- URL: `https://api.baseray.ai/v1/public/building-reports/{token}`
- Auth: none required

The report a token opens. While its Checkout is open the report is first settled from Stripe's current state, so it reads `paid` as soon as Stripe has the payment. A paid report opens its building for 12 months from payment (`accessUntil`). Limited per report: 240 reads a minute with one token, its building's reads included.

## Path parameters

- `token` string, required

## Response `200`

OK

- BuildingReport: A bought building report.
  - `status` 'pending' | 'paid' | 'expired', required: `pending` while Checkout is open, `paid`, or `expired` when Checkout closed unpaid.
  - `building` object, required
    - `id` string, uuid, required
    - `country` string, required: Lower case, as the public pages give it (`cz`).
    - `title` string, required: The building's address as its public page writes it.
  - `locale` 'en' | 'ro' | 'cs' | 'da', required: The language it was bought in.
  - `paidAt` string, date-time, nullable, required
  - `accessUntil` string, date-time, nullable, required: Until when the report opens its building: 12 months from payment.

## Other responses

- `404`: No report has this token (`not_found`).
- `429`: Too many reads with this report's token in a minute (`rate_limited`); 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)