---
title: "Get practitioner occupancy report"
method: GET
path: "/shop/reports/practitioner-occupancy"
tags: ["Reports"]
---

# Get practitioner occupancy report

`GET /shop/reports/practitioner-occupancy`

Returns a practitioner occupancy report for the given date/time range, showing bookable, blocked, appointment and session minutes per practitioner. The date range must not exceed 60 days. Requires the `REPORTS_VIEW` permission. When requesting a CSV export via the `Accept: text/csv` header, requires the `REPORTS_DOWNLOAD` permission instead.

## Query parameters

- `date_time_from` string, date-time, required
- `date_time_to` string, date-time, required
- `practitioner_ids` string
- `site_id` string, uuid

## Response `200`

Practitioner occupancy report data.

- PractitionerOccupancyReport
  - `data` PractitionerOccupancyItem[], required
    - `practitioner` PractitionerSummary, required — The summary of a `Practitioner` object
      - `id` string, object-id, required — The ID of the practitioner.
      - `name` string, required — The full name of the practitioner.
    - `bookable_mins` integer, required — Total bookable (available) minutes for the practitioner in the period.
    - `blocked_mins` integer, required — Total blocked minutes for the practitioner in the period.
    - `appointment_mins` integer, required — Total appointment minutes for the practitioner in the period.
    - `session_mins` integer, required — Total session minutes for the practitioner in the period.
  - `totals` PractitionerOccupancyTotals, required — Aggregated totals across all practitioners in the report.
    - `bookable_mins` integer, required — Total bookable minutes across all practitioners.
    - `blocked_mins` integer, required — Total blocked minutes across all practitioners.
    - `appointment_mins` integer, required — Total appointment minutes across all practitioners.
    - `session_mins` integer, required — Total session minutes across all practitioners.

## Other responses

- `400` — The request failed.
- `403` — The authenticated user does not have permission.

---

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