Reports

Queue practitioner occupancy report export

Queues a practitioner occupancy report for asynchronous CSV export. Returns a queued job resource that can be polled for completion. Requires the REPORTS_DOWNLOAD permission.

get/shop/reports/practitioner-occupancy/queue

Query parameters

date_time_fromstring date-time required

Example:2024-01-01T00:00:00+00:00

The start of the reporting period as an ISO 8601 date-time string (e.g. 2024-01-01T00:00:00+00:00). The range between date_time_from and date_time_to must not exceed 60 days.

date_time_tostring date-time required

Example:2024-01-31T23:59:59+00:00

The end of the reporting period as an ISO 8601 date-time string (e.g. 2024-01-31T23:59:59+00:00). Must be after date_time_from. The range between date_time_from and date_time_to must not exceed 60 days.

practitioner_idsstring

Example:5dcb56d0-59fe-4581-83e1-a7b7c2d3e4f5,6eca67e1-6aff-5692-94f2-b8c8d3e4f5a6

A comma-separated string of practitioner IDs to filter the report to specific practitioners.

site_idstring uuid

Example:5dcb56d0-59fe-4581-83e1-a7b7c2d3e4f5

The site ID to scope the report to.

Response

The report has been queued for export.

Example response

{
  "data": {
    "created_at": "2023-11-07T00:00:00+00:00",
    "updated_at": "2023-11-07T01:00:00+00:00"
  }
}

Changes

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