---
title: "Every operator's absences in a period"
method: GET
path: "/api/operators/absences"
tags: ["operators"]
---

# Every operator's absences in a period

`GET /api/operators/absences`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/operators/absences`
- Auth: HTTP bearer

Management overview of who is away between start_date and end_date, notes included. Admin and customer care only.

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required

## Response `200`

Successful Response

- OperatorAbsencesOverviewResponse: Every operator's absences overlapping a period; management callers only.
  - `absences` OperatorAbsenceOverviewItem[], required
    - `id` string, uuid, required
    - `operator_id` string, uuid, required
    - `type` 'vacation' | 'sick_leave' | 'maternity' | 'paternity' | 'other'
    - `start_date` string, date-time, required
    - `end_date` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `note` string, nullable
    - `created_by_user_id` string, uuid, nullable
    - `message` string, nullable
    - `operator_alert_action` string, nullable
    - `operator_alert_closed` boolean
    - `invalidate_all` boolean
    - `site_restricted` boolean
    - `operator_alert_sync` AvailabilityOperatorAlertSyncResponse
      - `action` string, nullable: Alert sync action: closed, created, or promoted
      - `alert_id` string, nullable: Operator alert UUID affected by the availability change
      - `alert_type` string, nullable: Operator alert type affected by the availability change
      - `closed` boolean: True when the availability change closed the alert
      - `invalidate_all` boolean: True when the frontend must invalidate all local route data
      - `site_restricted` boolean: True when the frontend must switch to restricted site mode
      - `message` string, nullable: Human-readable alert sync outcome
    - `operator_name` string, nullable
    - `operator_profession` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-15** `8515f4f7a8d5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/operators/absences/get.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/d8cdee1d5474?raw)