Absence types, holidays and working-time settings (tenant:access)
GET /api/hr/v1/work-config
Module: HR · operationId: getWorkConfig · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Responses
- 200 Configuration (
application/json)
Fields of the 200 answer:
absenceTypes(array of AbsenceType): Absence types of the tenantkey(string, required): Stable key of the typename(string, required): Display nameallowHalfDays(boolean): Half days may be requestedarchived(boolean): Archived: no longer offered for new data, kept for existing datacolor(string): Semantic colour of the type in calendars (one ofprimary,info,success,warning,error,neutral)countsAgainstVacation(boolean): Days of this type are taken from the vacation accounticon(string): Lucide icon (i-lucide-…)id(string): Id of the absence typepaid(boolean): The absence is paid timerequiresApproval(boolean): Requests start as requested and need a decision; otherwise they are approved when enteredsensitive(boolean): Colleagues see only "abwesend"sortOrder(integer): Position in lists (ascending)timeEffect(string): credit: counts as worked; none: the time account pays (Überstundenabbau); reduce_target: no target (unpaid) (one ofcredit,none,reduce_target)version(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
customHolidays(array of CustomHoliday): The tenant's own holidaysdate(string (date), required): Date (YYYY-MM-DD)fraction(number, required): 1 for a full day, 0.5 for a half day (one of0.5,1)name(string, required): Name of the holidayid(string): Id of the tenant holidayrecurring(boolean): Every year on the same dayversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
federalStates(array of FederalState): German states (Bundesländer) to choose fromcode(string): ISO 3166-2 suffix of the state (BW, BY, …)name(string): Name of the state
workSettings(WorkSettings)absencesVisibleToColleagues(boolean): Colleagues see each other's absences in the team calendar and presence; off: only the caller and the people they decide forautoEndAtMidnight(boolean): A clock segment nobody clocked out of is ended at 24:00 of its day (tenant time zone) and markedautoEndedfor checking. Off for tenants whose shifts run past midnight. (defaulttrue)carryoverExpiry(string): MM-DD the previous year's vacation expires (default"03-31")defaultDayMinutes(array of integer): Target minutes Monday … Sunday without a working-time modeldefaultVacationDays(number): Vacation days per year of employees without a working-time modelfederalState(string): Bundesland code (BW, BY, …); empty = nationwide holidays onlyselfEditDays(integer): Days back employees change their own time without a reasontimeZone(string): IANA time zone of the tenant, e.g. Europe/Berlin (default"Europe/Berlin")trackingStart(string (date)): First day time accounts count
Example 200 answer:
{
"absenceTypes": [
{
"allowHalfDays": true,
"archived": false,
"color": "primary",
"countsAgainstVacation": true,
"icon": "i-lucide-palmtree",
"id": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13",
"key": "vacation",
"name": "Erholungsurlaub",
"paid": true,
"requiresApproval": true,
"sensitive": false,
"sortOrder": 10,
"timeEffect": "credit",
"version": 1
},
{
"allowHalfDays": true,
"archived": false,
"color": "error",
"countsAgainstVacation": false,
"icon": "i-lucide-thermometer",
"id": "9e2a4c6e-8a0c-4e2a-9c6e-8a0c2e4a6c16",
"key": "sick",
"name": "Krankheit",
"paid": true,
"requiresApproval": false,
"sensitive": true,
"sortOrder": 20,
"timeEffect": "credit",
"version": 1
}
],
"customHolidays": [
{
"date": "2026-12-24",
"fraction": 0.5,
"id": "0e2a4c6e-8a0c-4e2a-8c6e-8a0c2e4a6c14",
"name": "Heiligabend (halber Tag)",
"recurring": true,
"version": 1
}
],
"federalStates": [
{
"code": "BY",
"name": "Bayern"
},
{
"code": "BW",
"name": "Baden-Württemberg"
}
],
"workSettings": {
"absencesVisibleToColleagues": true,
"autoEndAtMidnight": true,
"carryoverExpiry": "03-31",
"defaultDayMinutes": [
480,
480,
480,
480,
480,
0,
0
],
"defaultVacationDays": 30,
"federalState": "BY",
"selfEditDays": 14,
"timeZone": "Europe/Berlin",
"trackingStart": "2026-01-01"
}
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/work-config' \
-H "Authorization: Bearer $ACCESS_TOKEN"