14 endpoints

# Reports & Dashboards

Headcount reports, leave liability, asset reports, and role-specific dashboards.

GET`/reports/headcount/current`Current HeadcountGet current headcount totals, active/suspended/terminated counts, FTE, and employment-type totals.

GET`/reports/headcount/breakdown`Current Headcount BreakdownGet current active headcount and FTE grouped by department, location, and employment type.

GET`/reports/leave/liability`Leave Liability ReportReport positive paid leave balances and estimate their cost from current employee salary records.

GET`/reports/assets/utilization`Asset Utilisation ReportAsset utilisation by category: assigned, available and in maintenance.

GET`/reports/assets/maintenance-costs`Asset Maintenance CostsTotal maintenance costs by category and period.

GET`/dashboards/hr`HR DashboardAggregated HR metrics for the HR dashboard (headcount, leave, assets, and upcoming employee events).

GET`/dashboards/manager`Manager DashboardTeam-scoped metrics for manager dashboard.

GET`/dashboards/employee`Employee DashboardPersonal metrics for the authenticated employee.

GET`/reports/absence`Absence & Bradford Factor ReportAbsence by employee over a window, with the Bradford Factor score and trigger level. Only employees with an absence in the window, or a Bradford score above zero, are listed. The Bradford score always covers a rolling window ending today (absence.bradford_period_days, default 365 days), which is deliberately independent of from_date/to_date. Requires report.run.advanced; add format=csv for a download, which additionally requires report.export.

GET`/reports/turnover`Starters, Leavers & Turnover ReportStarters, leavers and turnover by month. Turnover is leavers divided by average headcount across the window (opening plus closing, halved). Leavers include their offboarding reason and any holiday settlement figure. Requires report.run.advanced; format=csv additionally requires report.export.

GET`/reports/probation`Probation ReportWho is approaching the end of their probation, and whose has already passed it. Requires report.run.basic; format=csv additionally requires report.export.

GET`/reports/compliance/expiry`Compliance Expiry ReportRight to work documents, DBS checks and employee documents that have expired or expire within the window, most urgent first. Requires report.run.advanced; format=csv additionally requires report.export.

GET`/reports/payroll-changes`Payroll Changes ReportEverything payroll needs telling about for a period: joiners, leavers (with their offboarding reason and holiday settlement), salary changes with the previous amount, benefit starts and ends, and job or contract changes read from the employee audit trail. Defaults to the current month. Requires report.run.advanced; format=csv additionally requires report.export.

GET`/reports/salary-history`Salary History ReportSalary records with the movement between consecutive records (change_amount and change_percent). Pass employee_uuid for one person, or omit it for everyone in scope. Requires employee.view_salary in addition to reporting access; format=csv additionally requires report.export.

---

**URL:** https://cube-hr.co.uk/docs/reports
