Absences

curl --location 'https://api.exode.biz/saas/v2/staff/absence/list?take=10&types=Vacation' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

curl --location 'https://api.exode.biz/saas/v2/staff/absence/list?take=10&types=Vacation' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

Request headers

string

required

The service user’s API token in the Bearer YOUR_TOKEN format. The school owner issues the token in the admin panel: Manage → School → For developers → API keys — see the “Authentication” section for details.

integer

required

The numeric ID of the seller — the account the school belongs to. Copy it on the API keys page, in the Integration data → Identifiers card. The token’s permissions are checked against this ID.

integer

required

The numeric ID of the school, found in the same place as Seller-Id. The value must match the seller’s school — otherwise a 400 error with cause: "ForbiddenSchoolMismatch" is returned.

An absence (absence) records a period when an employee is not working: an absence with no specified reason (Absent), a vacation (Vacation), a day off (DayOff), a business trip (BusinessTrip), sick leave (SickLeave), parental leave (ParentalLeave) or study leave (StudyLeave). An absence is linked to the employee’s employment, not to the user: if the employee has several jobs, specify the one the absence applies to (this does not affect the user’s status — absences across all of their employments are taken into account).

startAt and finishAt are points in time (ISO 8601, UTC), not calendar days. An absence is considered current while startAt ≤ now ≤ finishAt. Pass a vacation “from August 1 to August 14 inclusive” as startAt: "2026-08-01T00:00:00Z", finishAt: "2026-08-14T23:59:59Z" (adjusted for the company’s time zone): the value 2026-08-14T00:00:00Z would end the absence at the start of the 14th. Without finishAt, the absence lasts indefinitely until you set an end date.

Creating, updating and deleting an absence automatically syncs the user status Active ↔ OnLeave: if the user has a current (in effect right now) absence, the status becomes OnLeave; once no current absences remain, it returns to Active. OnLeave is an informational status: it does not block sign-in or access to the platform. These transitions do not affect users in other statuses (Banned, Blocked, Terminated). In addition to recalculating on API calls, the platform automatically reconciles statuses with the calendar once an hour: an absence with a future start date moves the employee to OnLeave when that date arrives, and an expired one returns them to Active, with no calls required on your side.

All staff module endpoints are available only to Corporate-segment schools. For other segments, the request returns 401 with cause: "Forbidden" and the message Allowed only for Corporate school.

List absences

GET /saas/v2/staff/absence/list

Requires authentication and the “Staff browsing” permission (StaffView).

Request parameters

Pass array parameters by repeating the parameter in the query string: employmentIds=1&employmentIds=2.

Pagination

integer

Number of records to skip. Defaults to 0.

integer

Page number (an alternative to skip). Starts at 1.

integer

Number of records per page. Defaults to 100, maximum 1000.

Filtering

string[]

Filter by absence external IDs (extId). Up to 250 values, each up to 50 characters.

integer[]

Filter by employment IDs. Up to 250 values. On a transfer or position change, absences stay on the closed employment record, so to get an employee’s full history, pass the IDs of all of their records — you can get them via employment/list?userIds=....

integer[]

Filter by position IDs (the position is taken from the employment the absence is linked to). Up to 250 values.

enum[]

Filter by absence types. Possible values: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave. Up to 250 values.

boolean

If true, return only current absences: startAt has already passed, and finishAt is not set or has not passed yet.

Response fields

object

Paginated list of absences.

Show payload properties

object[]

Array of absences.

Show Item properties

integer

Absence ID.

integer

School ID.

integer

Employee’s employment ID.

string | null

External ID from the client’s system. Unique within the school among non-deleted records.

enum

Absence type: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave or StudyLeave.

string

Absence start date (ISO 8601).

string | null

Absence end date (ISO 8601) or null.

string | null

Note on the absence.

string

Record creation date.

string

Last update date.

integer

Current page.

integer

Total number of records.

integer

Total number of pages.

boolean

Whether this is the first page.

boolean

Whether this is the last page.

object

Next page parameters (skip, take, page).

object

Previous page parameters (skip, take, page).

curl --location 'https://api.exode.biz/saas/v2/staff/absence/list?take=10&types=Vacation' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

Create an absence

POST /saas/v2/staff/absence/create

Requires authentication and the “Staff Management” permission (StaffManage).

Request parameters

Specify the employment with exactly one of two fields: employmentId or employmentExtId.

string

External ID of the absence from the client’s system. 1 to 50 characters, no / or whitespace. Must be unique within the school among non-deleted records — otherwise the StaffAbsenceExtIdIsNotUniq error is returned.

integer

ID of the employee’s employment the absence applies to. Required if employmentExtId is not passed. You can also specify an already closed record — for example, when migrating absence history.

string

External ID (extId) of the employment — the one you passed when hiring. An alternative to employmentId; required if employmentId is not passed. Looked up only among the school’s open (not terminated) employments; if none is found, the StaffEmploymentNotFound error is returned.

enum

required

Absence type. Possible values: Absent (absent), Vacation (vacation), DayOff (day off), BusinessTrip (business trip), SickLeave (sick leave), ParentalLeave (parental leave), StudyLeave (study leave).

string

required

Absence start date in ISO 8601 format. Must not be later than finishAt.

string

Absence end date in ISO 8601 format. Must not be earlier than startAt, otherwise the request is rejected. Omit it if the end date is not yet known.

string

Note on the absence. Maximum 500 characters. Leading and trailing whitespace is trimmed automatically.

curl --location 'https://api.exode.biz/saas/v2/staff/absence/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "extId": "1c-absence-2024-001",
    "employmentId": 9,
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation"
  }'

const axios = require('axios');

const createAbsence = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/absence/create', {
    extId: '1c-absence-2024-001',
    employmentId: 9,
    type: 'Vacation',
    startAt: '2026-07-06T00:00:00.000Z',
    finishAt: '2026-07-20T00:00:00.000Z',
    note: 'Summer vacation',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

createAbsence();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.341Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceInvalidInterval",
  "message": "Staff absence interval is invalid",
  "error": "Staff absence interval is invalid"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceExtIdIsNotUniq",
  "message": "Staff absence extId is not uniq",
  "error": "Staff absence extId is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff employment not found",
  "error": "Staff employment not found"
}

Update an absence

PUT /saas/v2/staff/absence/{absenceId}/update

Requires authentication and the “Staff Management” permission (StaffManage). Updates absence fields. All body fields are optional — pass only the ones you want to change. The employment link (employmentId) cannot be changed.

Request parameters

integer

required

ID of the absence to update.

string

enum

Absence type. Possible values: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave.

string

Absence start date in ISO 8601 format. Must not be later than finishAt.

string | null

Absence end date in ISO 8601 format. Must not be earlier than startAt (taking into account the already stored value if startAt is not passed), otherwise StaffAbsenceInvalidInterval is returned. null clears the end date — the absence becomes open-ended.

string

Note on the absence. Maximum 500 characters.

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/absence/2/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "note": "Summer vacation (updated)"
  }'

const axios = require('axios');

const updateAbsence = async () => {
  const { data } = await axios.put('https://api.exode.biz/saas/v2/staff/absence/2/update', {
    note: 'Summer vacation (updated)',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

updateAbsence();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.354Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation (updated)"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceInvalidInterval",
  "message": "Staff absence interval is invalid",
  "error": "Staff absence interval is invalid"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceExtIdIsNotUniq",
  "message": "Staff absence extId is not uniq",
  "error": "Staff absence extId is not uniq"
}

Update an absence by extId

PUT /saas/v2/staff/absence/ext/{extId}/update

Requires authentication and the “Staff Management” permission (StaffManage). Same as updating by absenceId, but the absence is identified by its external ID (extId) within the school. The request body is the same as for PUT /saas/v2/staff/absence/{absenceId}/update.

Request parameters

string

required

External ID of the absence to update. Pass it URL-encoded.

string

New external ID of the absence. 1 to 50 characters, no / or whitespace. Must be unique within the school among non-deleted records.

enum

Absence type. Possible values: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave.

string

Absence start date in ISO 8601 format. Must not be later than finishAt.

string | null

string

Note on the absence. Maximum 500 characters.

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/absence/ext/1c-absence-2024-001/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "note": "Summer vacation (updated)"
  }'

const axios = require('axios');

const updateAbsenceByExtId = async () => {
  const extId = encodeURIComponent('1c-absence-2024-001');

  const { data } = await axios.put(`https://api.exode.biz/saas/v2/staff/absence/ext/${extId}/update`, {
    note: 'Summer vacation (updated)',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

updateAbsenceByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.354Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation (updated)"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceNotFound",
  "message": "Staff absence not found",
  "error": "Staff absence not found"
}

Delete an absence

DELETE /saas/v2/staff/absence/{absenceId}/delete

Requires authentication and the “Staff Management” permission (StaffManage).

Request parameters

integer

required

ID of the absence to delete.

Response

integer

required

Number of deleted records (1 on successful deletion).

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/absence/2/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const deleteAbsence = async () => {
  const { data } = await axios.delete('https://api.exode.biz/saas/v2/staff/absence/2/delete', {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

deleteAbsence();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffManage",
  "message": "Forbidden seller resource - permissions StaffManage"
}

Delete an absence by extId

DELETE /saas/v2/staff/absence/ext/{extId}/delete

Requires authentication and the “Staff Management” permission (StaffManage). Same as deleting by absenceId, but the absence is identified by its external ID (extId) within the school.

Request parameters

string

required

External ID of the absence to delete. Pass it URL-encoded.

Response

integer

required

Number of deleted records (1 on successful deletion).

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/absence/ext/1c-absence-2024-001/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const deleteAbsenceByExtId = async () => {
  const extId = encodeURIComponent('1c-absence-2024-001');

  const { data } = await axios.delete(`https://api.exode.biz/saas/v2/staff/absence/ext/${extId}/delete`, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

deleteAbsenceByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceNotFound",
  "message": "Staff absence not found",
  "error": "Staff absence not found"
}

Permission requirements

The staff module is available only to Corporate-segment schools. Reading the list requires the “Staff browsing” permission (StaffView); creating, updating and deleting absences requires the “Staff Management” permission (StaffManage).

The service user must be authenticated with a token and have the appropriate access permissions for the specified school.

Updated: 2026-09-25 14:33 UTC

Working with the API

Users

Staff (HR)

Groups

Courses

Access and sales

Reports and exports

Custom fields

Forms

Missing a method?

All objects

Request headers

List absences

Request parameters

Filtering

Response fields

Create an absence

Request parameters

Update an absence

Request parameters

Update an absence by extId

Request parameters

Delete an absence

Request parameters

Response

Delete an absence by extId

Request parameters

Response

Permission requirements

​Request headers

​List absences

​Request parameters

​Pagination

​Filtering

​Response fields

​Create an absence

​Request parameters

​Update an absence

​Request parameters

​Update an absence by extId

​Request parameters

​Delete an absence

​Request parameters

​Response

​Delete an absence by extId

​Request parameters

​Response

​Permission requirements

Request headers

List absences

Request parameters

Pagination

Filtering

Response fields

Create an absence

Request parameters

Update an absence

Request parameters

Update an absence by extId

Request parameters

Delete an absence

Request parameters

Response

Delete an absence by extId

Request parameters

Response

Permission requirements