GET

List time entries for an employee

Scope: team:time-tracking.read https://api.alladdin.com/api/v2/employees/{employeeId}/times

Returns a paginated list of time tracking entries for a specific employee.
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.

Parameters

Path parameters

employeeId string required

Employee ID

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

startDate string<date> optional

Filter entries starting on or after this date (ISO 8601, YYYY-MM-DD)

endDate string<date> optional

Filter entries starting on or before this date (ISO 8601, YYYY-MM-DD)

Request

python

import requests

url = "https://api.alladdin.com/api/v2/employees/{employeeId}/times?cursor=page:2&limit=50&startDate=2025-01-01"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

json

{
  "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

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Employee not found application/json 429 Rate limit exceeded application/json

← PreviousUpdate an employee time entry →

Next →List all employee time entries →

Alladdin