Your browser is not up to date. This may cause security, speed, and display
issues. Please update your browser.
Update Browser
X
Clockodo API:
Read work times
Endpoint api/v2/workTimes
With this resource you can read work times. Editing work times directly is not possible. To edit work times, edit the respective time entries or use requests for change of work time.
This endpoint will yield valid data starting on Monday, August 21, 2023.
All about the endpoint api/v2/workTimes
Object type "workTimeDay"
| Parameter | Type | Description |
|---|---|---|
| date | string | |
| users_id | integer |
ID of the user
|
| offset | integer |
Additional work time that does not result form the day's intervals
Only possible for days before 2023-01-01; can be positive or negative
|
| intervals | workTimeInterval[] |
the work time intervals of the day
|
Object type "workTimeInterval"
| Parameter | Type | Description |
|---|---|---|
| time_since | string |
Start of the interval
in format ISO 8601 UTC, e.g. "2023-07-30T12:34:56Z"
|
| time_until | string |
End of the interval
in format ISO 8601 UTC, e.g. "2023-07-30T12:34:56Z"
|
List work times
Request
GET /api/v2/workTimes
| Required parameters | date_since | string |
Start of the period for which work times are being requested
|
|---|---|---|---|
| date_until | string |
End of the period for which work times are being requested
| |
| users_id | integer |
ID of the co-worker whose work times are being requested
|
Response
{
"paging": [paging information],
"work_time_days":
{
[object of type workTimeDay],
[object of type workTimeDay],
...
}
}