Skip to main content
GET
List employee badges

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

The employee's employee_id, as returned by the employee and leaderboard endpoints.

Example:

"8d2f6b1e-4c3a-4f5e-b7d9-1a2c3e4f5a6b"

Query Parameters

cursor
string

The pagination.next_cursor of the previous page. Omit it, or send it empty, for the first page. A cursor is opaque and works only on the endpoint that returned it, for the same company.

Maximum string length: 512
Example:

"djEuQ2hhY2hhMjAuZXhhbXBsZS1jdXJzb3I"

limit
integer
default:25

How many items to return per page, from 1 to 100.

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

25

Response

A page of the employee's badges.

data
object[]
required

Badges on this page, most recently awarded first.

pagination
object
required

Where the next page starts.