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 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
}