ConnectCloud Developers

Working days, holidays and remaining vacation of a planned absence

GET /api/hr/v1/absences/preview

Module: HR · operationId: previewAbsence · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
employeeId query string
typeId query string yes
startDate query string (date) yes
endDate query string (date) yes
startHalf query boolean
endHalf query boolean
except query string Absence being edited

Responses

  • 200 Preview (application/json)
  • 400 Error (application/json)

Fields of the 200 answer:

  • days (number): Working days the absence would count (halves allowed)
  • holidays (array of Holiday): Holidays inside the period (not counted)
    • custom (boolean): A holiday of the tenant's own (omitted when false)
    • date (string (date)): Date (YYYY-MM-DD)
    • fraction (number): 1 for a full day, 0.5 for a half day (e.g. 24.12.) (one of 0.5, 1)
    • name (string): Name of the holiday
  • overlaps (boolean): The period overlaps another absence of the employee
  • remaining (number): Vacation left in the start year afterwards (vacation types only)

Example 200 answer:

{
  "days": 5,
  "holidays": [],
  "overlaps": false,
  "remaining": 4
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/hr/v1/absences/preview?typeId=string&startDate=2026-03-02&endDate=2026-03-02' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI