Retrieve an employee
curl --request GET \
--url https://api.teambuilder.ge/v1/employees/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.teambuilder.ge/v1/employees/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.teambuilder.ge/v1/employees/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"employee_id": "8d2f6b1e-4c3a-4f5e-b7d9-1a2c3e4f5a6b",
"external_id": "EMP-00042",
"name": "Nino Beridze",
"email": "nino.beridze@example.com",
"department": {
"id": "b3e1f7a2-6c4d-4e8f-9a1b-2c3d4e5f6a7b",
"external_id": "D-ENG",
"name": "Engineering"
}
}{
"error": {
"code": "validation_failed",
"message": "Validation failed (uuid is expected)",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid API key",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "forbidden",
"message": "This API key lacks the required scope: employees:read",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "not_found",
"message": "Employee not found",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after 30 seconds.",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}Retrieve an employee
Read one active employee by employee_id.
GET
/
v1
/
employees
/
{id}
Retrieve an employee
curl --request GET \
--url https://api.teambuilder.ge/v1/employees/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.teambuilder.ge/v1/employees/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.teambuilder.ge/v1/employees/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"employee_id": "8d2f6b1e-4c3a-4f5e-b7d9-1a2c3e4f5a6b",
"external_id": "EMP-00042",
"name": "Nino Beridze",
"email": "nino.beridze@example.com",
"department": {
"id": "b3e1f7a2-6c4d-4e8f-9a1b-2c3d4e5f6a7b",
"external_id": "D-ENG",
"name": "Engineering"
}
}{
"error": {
"code": "validation_failed",
"message": "Validation failed (uuid is expected)",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid API key",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "forbidden",
"message": "This API key lacks the required scope: employees:read",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "not_found",
"message": "Employee not found",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after 30 seconds.",
"request_id": "req_7Hq2LmX9vT4kPz1RbN8sWc"
}
}Authorizations
API key — tb_live_… for production data, tb_test_… for the sandbox.
Path Parameters
The employee's employee_id, as returned by the employee and leaderboard endpoints.
Example:
"8d2f6b1e-4c3a-4f5e-b7d9-1a2c3e4f5a6b"
Response
The employee.
TeamBuilder id of the employee. Stable for as long as they are in your company.
Example:
"8d2f6b1e-4c3a-4f5e-b7d9-1a2c3e4f5a6b"
The employee's key in your HR system. Null if none was set.
Example:
"EMP-00042"
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"
Work email address.
Example:
"nino.beridze@example.com"
The department the employee belongs to. Null if they have none.
Show child attributes
Show child attributes
