- Overview
- What's New in V8?
- Changelog
- Open API Specification 3.0.0 (OAS)
- API Directory
- API Collection
- APIs and References
- OAuth
- API Limits and Credits
- Compliance
- Zoho CRM SDKs
- Metadata APIs
- Customization
- Process Automation
- Security control
- Roles
- Profiles
- Territories
- GETTerritories
- POSTTerritories
- PUTTerritories
- DELETETerritories
- POSTTransfer and Delete Territories
- GETChild Territories of a Territory
- GETTerritories Assigned
- GETAssociated User Count
- GETRetrieve User details Associated with a Territory
- PUTAssociate Users with Territory
- POSTRemove Territories of Records
- POSTAssign Territories to Records
- DELETEDisassociate Users from Territory
- Export Audit Log
- Portals
- Data Sharing
- Company Settings
- Zia
- Core APIs
- Records
- Merge Records
- Share Records
- Mail Merge
- Services
- Appointments
- Appointments Rescheduled History
- Fields Attachments
- Meeting Cancel
- Notes
- Mass Actions
- Related Records
- External ID
- Emails
- Subforms
- Linking Modules
- Others
- Bulk APIs
- Composite API
- Query API
- Notification APIs
Get the List of Holidays
Purpose
To get the details of the holidays set for your org.
Endpoint
- GET /settings/holidays
- GET /settings/holidays/{holiday_ID}
Request Details
Request URL
{api-domain}/crm/{version}/settings/holidays
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
X-CRM-ORG:{your_org_id}
Scope
scope=ZohoCRM.settings.business_hours.ALL
(or)
scope=ZohoCRM.settings.business_hours.READ
Parameters
- yearoptional
The year that the holiday falls in.
- typeoptional
The type of holiday that you want to fetch. The possible values are business_holiday and shift_holiday.
- shift_idoptional
The ID of the shift hour whose holidays you want to fetch. Use the Get Shift Hours API to get the ID of the shift hour.
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/holidays?shift_id=3652397000011173006"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-H "X-CRM-ORG:{your_org_id}"
-X GET
Possible Errors
- API_NOT_SUPPORTEDHTTP 400
You are trying the API from API version 2 or below.
Resolution: This API is supported only from API version 2.1 and up. - OAUTH_SCOPE_MISMATCHHTTP 401
You do not have the right scope to access this API.
Resolution: Create new token with ZohoCRM.settings.business_hours.ALL or ZohoCRM.settings.business_hours.READ scopes. - INACTIVE_USERHTTP 403
You are an inactive user in the org.
Resolution: Inactive users cannot access this API. Contact the administrator. - INVALID_URL_PATTERNHTTP 404
Please check if the URL trying to access is a correct one
Resolution: The request URL specified is incorrect. Specify a valid request URL. Refer to the request URL section above.
Sample Response
Copied{
"holidays": [
{
"date": "2023-04-24",
"year": 2023,
"name": "Founder's Day",
"id": "3652397000011173008",
"type": "shift_holiday",
"shift_hour": {
"name": "shift hour for TX",
"id": "3652397000011173006"
}
}
],
"info": {
"per_page": 200,
"count": 1,
"page": 1,
"more_records": false
}
}
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.