---
title: "Bookable area occupancy report"
method: GET
path: "/shop/reports/bookable-area-occupancy"
tags: ["Reports"]
---

# Bookable area occupancy report

`GET /shop/reports/bookable-area-occupancy`

For each bookable area at the requested site, returns bookable / blocked / booked
minutes across the requested date range. Capped to 60 days per request — for larger
ranges, queue an export with
[`/shop/reports/bookable-area-occupancy/queue`](/endpoints/Reports#queueBookableAreaOccupancyExport).

## Query parameters

- `site_id` string, uuid
- `date_from` string, date, required
- `date_to` string, date, required
- `bookable_area_ids` string[]
- `zone_id` string[]

## Response `200`

The report was successfully generated.

- BookableAreaOccupancyResponse — For each bookable area at the site, the number of bookable / blocked / booked minutes across the requested date range.
  - `data` BookableAreaOccupancyRow[], required
    - `bookable_area` SchemasBookableAreaSummary, required
      - `id` string, object-id, required
      - `name` string, required
    - `bookable_mins` integer, required
    - `blocked_mins` integer, required
    - `booked_mins` integer, required
  - `totals` BookableAreaOccupancyTotals, required
    - `bookable_mins` integer, required
    - `blocked_mins` integer, required
    - `booked_mins` integer, required

## Other responses

- `400` — The request failed.

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)
