# ListHolidayCalendars

## Overview

ListHolidayCalendars returns a paginated list of all `HolidayCalendar` records, for admin review of the calendars available to scope `CompanyHoliday` entries and `WorkRule` holiday classification.

## Business Rules

- Results are paginated per the standard PaginationInput / buildPaginatedResult conventions
- Returns every calendar, whether or not it is currently referenced by a `CompanyHoliday` or `WorkRule`
- `HolidayCalendar` is master data, not effective-dated — the list reflects the current set of calendars, with no historical generations

## Process Flow

```mermaid
flowchart TD
    A[Caller provides pagination] --> B[Query all HolidayCalendar records]
    B --> C[Apply pagination]
    C --> D[Return paginated list of HolidayCalendar]
```

## External Dependencies

- [time-tracking::HolidayCalendar](../model/HolidayCalendar.md) model — entity being queried

## Error Scenarios

- **VALIDATION_ERROR**: the supplied input is malformed, out of range, or references an unrecognized enum value

## Test Cases

- returns a paginated list of HolidayCalendar records
- returns an empty page when no calendars match the requested page
- a calendar referenced by a `CompanyHoliday` or `WorkRule` still appears in the list