- Overview
- What's New in V7?
- Changelog
- API Directory
- API Collection
- OAuth Authentication
- OAuth Scopes
- API Limits
- Multi DC Support
- Increase API Credits
- Customize API Usage Notification
- GDPR Compliance
- HIPAA Compliance
- API Dashboard
- HTTP Request Methods
- Status Codes
- Zoho CRM SDKs
- Metadata APIs
- Modules
- Fields
- Layouts
- Related Lists
- Profiles
- Custom View
- Roles
- Global Picklists
- 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
- Scoring Rules
- Variables
- Map Dependency
- Duplicate Check Option
- Data Enrichment
- Create Export Audit Log
- User Groups
- Tags
- Unsubscribe Links
- Cadences
- Pipeline
- Wizards
- Assignment Rules
- Templates
- User's Unavailability
- Portals
- Fiscal Year
- Business Hours
- Holidays
- Record Locking Configuration
- Shift Hours
- Entity APIs
- Organization
- Users
- Records
- Related Records
- Records APIs using External ID
- Related Records Using External ID
- Merge Records
- List of Available APIs
- Features
- Meeting Cancel
- Linking Modules
- Subforms
- Contact Roles
- Photos and Attachments
- Mass Update
- Mass Delete
- Currencies
- Files
- Share
- Fields Attachments
- Recycle Bin
- Change Owner
- Mass Change Owner
- Emails
- Blueprint
- Notes
- Bulk APIs
- Composite API
- Notification APIs
- Query API
Get the List of Holidays
Purpose
To get the details of the holidays set for your org.
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/v7/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.