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

# Practitioner utilisation report

`GET /shop/reports/practitioner-utilisation`

For each practitioner working at the given site, returns bookable / booked / blocked
minutes and attributed net revenue across the requested date range. Capped to 31 days
per request — for larger ranges, queue an export with
[`/shop/reports/practitioner-utilisation/queue`](/endpoints/Reports#queuePractitionerUtilisationExport).

## Query parameters

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

## Response `200`

The report was successfully generated.

- PractitionerUtilisationResponse — For each practitioner, the number of minutes available vs. booked vs. blocked across the requested date range, along with attributed net revenue.
  - `data` PractitionerUtilisationRow[], required
    - `practitioner_id` string, object-id, required
    - `practitioner_name` string, required
    - `bookable_mins` integer — Bookable minutes within the requested range.
    - `appointment_mins` integer — Minutes spent on appointments.
    - `session_mins` integer — Minutes spent on sessions.
    - `blocked_mins` integer — Minutes blocked off and unavailable for bookings.
    - `net_revenue` integer — Net revenue attributed to this practitioner, in minor units.
  - `totals` PractitionerUtilisationTotals, required
    - `bookable_mins` integer, required
    - `appointment_mins` integer, required
    - `session_mins` integer, required
    - `blocked_mins` integer, required
    - `net_revenue` integer, required
  - `meta` PractitionerUtilisationMeta, required
    - `date_from` string, date, required
    - `date_to` string, date, 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)