Calamari Public API (v1)

API for Calamari, your HR tool

Download OpenAPI description
calamari-public-openapi.json
calamari-public-openapi.yaml
Overview
URL

https://developers.calamari.io

Calamari Team

developers@calamari.io

Languages
Servers

https://{tenantName}.calamari.io/api/

Absence requests

Operations

Absence type

Operations

Contract types

Operations

Current shift status

Operations

Employees

Operations

Holidays

Operations

Find public holidays for employee in dates range.

Request

Find public holidays for employee in dates range.

Expect error codes:

  1. INVALID_EMPLOYEE - when invalid employee id provided
  2. INVALID_DATE_FROM - when invalid time in filter provided
  3. INVALID_DATE_TO - when invalid time in filter provided

Bodyapplication/json
employeestringrequired

Employee e-mail or login

Example: "john.white@mycompany.com"
fromstring(date)required

Start date of dates range to search in ISO format

Example: "2017-01-10"
tostring(date)required

End date of dates range to search in ISO format

Example: "2017-01-15"
curl -i -X POST \
  -u <username>:<password> \
  https://awesome-company.calamari.io/api/holiday/v1/find \
  -H 'Content-Type: application/json' \
  -d '{
    "employee": "john.white@mycompany.com",
    "from": "2017-01-10",
    "to": "2017-01-15"
  }'

Responses

successful operation

Bodyapplication/jsonArray [
namestringrequired

Public holiday name

Example: "Holiday name"
startstring(date)required

First day of the holiday

Example: "2017-02-20"
endstring(date)required

Last day of the holiday

Example: "2017-02-20"
halfDaybooleanrequired

Half day holiday

halfdayPeriodstringrequired

If halfDay is true halfdayPeriod tells which part of day is non-working

Enum"AM""PM""null"
]
Response
application/json
[
  {
    "name": "Holiday name",
    "start": "2017-02-20",
    "end": "2017-02-20",
    "halfDay": true,
    "halfdayPeriod": "AM"
  }
]

Positions

Operations

Projects

Operations

Shifts and breaks

Operations

Teams

Operations

Timesheet entries

Operations

Working Week

Operations

People (Beta)

Endpoints related to managing people records.

Operations

People

Endpoints related to managing people records.