## 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:

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

### Example request

```bash
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"
```
