Zoho People icon

Zoho People

Consume Zoho People API

Leave → Get All Holidays V2

AI-generated

Summary

Retrieve a list of holidays from Zoho People optionally filtered by employee, date range, location, shift, and whether to include only upcoming holidays.

Inputs

  • Date Format — Specify the date format used for From and To date parameters (default is 'dd-MMM-yyyy').
  • Employee — Filter holidays for a specific employee identified by 'all', Email ID, Employee ID, or Erec No.
  • From Date — Start date to filter holidays (format based on Date Format parameter).
  • To Date — End date to filter holidays (format based on Date Format parameter).
  • Location — Filter holidays by location name.
  • Shift — Filter holidays by shift name.
  • Upcoming — Set to true to retrieve holidays for the next 365 days only.

Output shape

a list of holiday records matching the specified filters

The output is a JSON array of holiday objects. If no filters are specified, it returns all holidays. Date parameters should follow the specified Date Format. The 'Upcoming' flag overrides date filtering to limit holidays to the next 365 days.

Examples

Example 1: Get all holidays for employee XYZ000 from 01-Jan-2024 to 31-Dec-2024

Set Employee to 'XYZ000'; From Date to '01-Jan-2024'; To Date to '31-Dec-2024'. Use default Date Format 'dd-MMM-yyyy'.

Discussion