list_holidays
Query leave bookings for your organisation using filters like date range, status, user or department. Results are paginated for easy browsing.
Instructions
Query leave bookings ("holidays") for the organisation.
All filters are optional. Results are paginated at 100 per page — use
page_number and read totalRecords/nextPageLink in the response.
Args:
start: Include holidays on or after this date-time (ISO 8601).
end: Include holidays before and including this date-time (ISO 8601).
status: Filter by status. Defaults to pending + approved if omitted.
user_ids: Comma-separated user IDs to include (e.g. "12,34").
exclusion_user_ids: Comma-separated user IDs to exclude.
department_id: Only holidays for this department.
leave_type_id: Only holidays of this leave type.
approver_id: Only holidays approved by this user.
my_team_only: Restrict to the team of this user ID.
my_favourites_only: Restrict to the favourite users of this user ID.
department_managers_only: Only holidays for department managers.
non_archived_users_only: Exclude archived users.
transaction_year: Filter to this transaction year.
page_number: Page to fetch (defaults to 1).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| start | No | ||
| status | No | ||
| user_ids | No | ||
| approver_id | No | ||
| page_number | No | ||
| my_team_only | No | ||
| department_id | No | ||
| leave_type_id | No | ||
| transaction_year | No | ||
| exclusion_user_ids | No | ||
| my_favourites_only | No | ||
| non_archived_users_only | No | ||
| department_managers_only | No |