List all employee time entries
Scope: team:time-tracking.read https://api.alladdin.com/api/v2/employee-times
Returns a paginated list of all employee time tracking entries for the account.
Results are cursor-paginated: the response includes a cursor value and a has_more boolean. Pass the cursor to the next request to fetch the following page. Default page size is 50, configurable up to 200.
Parameters
Query parameters
cursor string optional
Opaque cursor for pagination. Use the value returned in the previous response to fetch the next page.
limit integer optional = 50
Maximum number of items to return
Request
import requests
url = "https://api.alladdin.com/api/v2/employee-times?cursor=page:2&limit=50"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"employee_id": "507f1f77bcf86cd799439012",
"employee_name": "string",
"date": "2024-01-15T10:30:00Z",
"start_at": "2024-01-15T10:30:00Z",
"end_at": "2024-01-15T10:30:00Z",
"duration": 0,
"status": "string",
"approved": false,
"approved_by": "string",
"approved_at": "2024-01-15T10:30:00Z"
}
],
"has_more": false,
"cursor": "string"
}Success responses
200 List of employee time entries application/json object items[] object[] required id string required
Unique identifier
employee_id string required
Employee ID
employee_name string | null required
Employee display name
date string<date-time> | null required
Date of the time entry in ISO 8601
start_at string<date-time> required
Start time in ISO 8601
end_at string<date-time> | null required
End time in ISO 8601
duration integer required
Duration in seconds
status string required
Tracker status (running, done)
approved boolean required
Whether the entry is approved
approved_by string | null required
User ID who approved
approved_at string<date-time> | null required
Approval date in ISO 8601
has_more boolean required
Whether there are more items on the next page
cursor string | null optional
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Error responses
401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json