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

Positions

Operations

Get all positions.

Request

Get all positions.

curl -i -X POST \
  -u <username>:<password> \
  https://awesome-company.calamari.io/api/positions/v1/all

Responses

successful operation

Bodyapplication/jsonArray [
idinteger(int64)required

Position id

namestringrequired

Position name

Example: "Manager"
]
Response
application/json
[
  {
    "id": 0,
    "name": "Manager"
  }
]

Create a position.

Request

Create a position.

Bodyapplication/json
positionNamestring[ 1 .. 2147483647 ] charactersrequired

Position name.

Example: "Manager"
membersArray of integers(int64)required

Ids of employees in the position.

curl -i -X POST \
  -u <username>:<password> \
  https://awesome-company.calamari.io/api/positions/v1/create \
  -H 'Content-Type: application/json' \
  -d '{
    "positionName": "Manager",
    "members": [
      0
    ]
  }'

Responses

successful operation

Bodyapplication/json
idinteger(int64)required

Id of the created position.

Example: 1
Response
application/json
{
  "id": 1
}

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.