Get Shift Hours
Purpose
To get the details of the shift hours configured for your solution organization.
Request Details
Request URL
To get all shift hours: {api-domain}/crm/{version}/settings/business_hours/shift_hours
To get a specific shift hour: {api-domain}/crm/{version}/settings/business_hours/shift_hours/{shift_hour_id}
Header
Authorization: Zoho-oauthtoken 100xx.92d4xxxxxxxxxxxxx15f52
X-CRM-ORG:{your_org_id}
Scope
scope=ZohoCRM.settings.business_hours.ALL
(or)
scope=ZohoCRM.settings.business_hours.READ
When users in the "Admin" profile and those with "Manage Users" permission fetch a specific shift hour, the response will have the "users" array populated with the details of the user such as their email ID, ZUID, role etc,. For others, this key will hold the value "null".
Sample Request
Copied
Possible Errors
- INVALID_DATAHTTP 400
The ID of the shift hour you want to fetch is incorrect.
Resolution: Give the right ID of the shift hour. - 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. - NO_PERMISSIONHTTP 403
You d not have the "Manage Users" permission.
Resolution: Contact your administrator to obtain the necessary permission to perform this action. - INVALID_REQUEST_METHODHTTP 404
The HTTP request method is incorrect.
Resolution: The HTTP method is GET to fetch the details of a shift hour.
Sample Response
Copied
Show full
Show less