Skip to main content
GET
Retrieve an employee

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"

Response

The employee.

employee_id
string<uuid>
required

TeamBuilder id of the employee. Stable for as long as they are in your company.

Example:

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

external_id
string | null
required

The employee's key in your HR system. Null if none was set.

Example:

"EMP-00042"

name
string | null
required

Full name. Until the employee first signs in, this is the name your roster sync sent, or null if it sent none; afterwards, the name on their TeamBuilder account.

Example:

"Nino Beridze"

email
string<email>
required

Work email address.

Example:

"nino.beridze@example.com"

department
object | null
required

The department the employee belongs to. Null if they have none.