Reports

Practitioner utilisation report

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.

get/shop/reports/practitioner-utilisation

Query parameters

site_idstring uuid required

Restrict the report to the given site. Required.

date_fromstring date required

Example:2026-06-01

Restrict to bookings on or after this date. Required. The range between date_from and date_to cannot exceed 31 days.

date_tostring date required

Example:2026-06-30

Restrict to bookings on or before this date. Required.

zone_idstring[]

A comma-separated list of zone IDs to restrict practitioners to.

Response

The report was successfully generated.

Example response

{
  "data": [
    {
      "practitioner_id": "60a8c0901d210625e3a87667",
      "practitioner_name": "Sarah Smith",
      "bookable_mins": 2400,
      "appointment_mins": 1500,
      "session_mins": 200,
      "blocked_mins": 60,
      "net_revenue": 180000
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.