Skip to main content
GET
Get the leaderboard by department
Departments are listed by name, not ranked against each other. See Grouped by department.

Authorizations

Authorization
string
header
required

API key — tb_live_… for production data, tb_test_… for the sandbox.

Query Parameters

period
enum<string>
default:all_time

The window XP is counted over. Months are calendar months in UTC.

  • all_time: all XP ever earned.
  • this_month: XP earned since the 1st of the current month.
  • last_3_months: XP earned in the current month and the two before it.
  • last_year: XP earned in the current month and the eleven before it.
Available options:
all_time,
this_month,
last_3_months,
last_year
Example:

"this_month"

limit_per_department
integer
default:5

How many top members to list for each department, from 1 to 25.

Required range: 1 <= x <= 25
Example:

3

Response

The departments and their leaders.

data
object[]
required

One entry per active department (empty ones included, plus any archived department that still has members), ordered by name ignoring case, then one for employees without a department if there are any.

pagination
object
required

Always a single page: next_cursor is always null.

Example: