clockodo Logo

REST-API

The clockodo API allows you to connect clockodo to other systems. Accounting and project management applications or proprietary shell scripts are examples of useful mash-ups with clockodo.

api/holidayscarry: Manage holiday carryovers

Object type „holidayscarryRow“

Parameter Type Description
users_id integer The related employee's ID
year integer Year for which the holiday carryover applies Format YYYY
count float (only full and half values allowed) Day count
note string|null Note

List holiday carryovers

Request
GET /api/holidayscarry
Optionale Parameter users_id (integer) Restrict data to this user
year (integrer) Restrict data to this year
Response
{
  "holidayscarry": 
  {
    [object of type holidayscarryRow],
    [object of type holidayscarryRow], 
    ...
  }
}

Request single holiday carryover

Request
GET /api/holidayscarry/[USERS_ID]/[YEAR]
Response
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Add holiday carryover

Request
POST /api/holidayscarry
Required parameters users_id, year, count
Optional parameters note
Response
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Edit holiday carryover

Request
PUT /api/holidayscarry/[USERS_ID]/[YEAR]
Optional parameters count, note
Response
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Delete holiday carryover

Request
DELETE /api/holidayscarry/[USERS_ID]/[YEAR]
Response
{
  "success": true
}