Fetch Services
Table of Contents
Purpose
To fetch all services under a workspace.
Request URL
https://www.zohoapis.com/bookings/v1/json/services
Headers
Parameter Name | Description |
---|---|
Authorization | Zoho-oauthtoken {{accesstoken}} |
Note: The access token can be generated from the developer console.
Request Method
GET
Parameters
Parameters to be passed along with the request URL are,
Parameter Name | Description |
---|---|
workspace_id * | The unique id of the workspace whose services need to be fetched. |
service_id (optional) | The unique id of the service under a specified workspace which needs to be fetched. |
staff_id (optional) | The unique id of the staff under a specified service which needs to be fetched. |
Note: fields marked * are mandatory.
Response Type
JSON
API Limits
Zoho Bookings Plan/Edition | Number of API calls/day |
Free | 250/per user |
Basic | 1000/per user |
Premium | 3000/per user |
Zoho One | 3000/per user |
Note: The API limits are excluding the authorization requests. API counts are calculated between 00:00 and 23:59 hours in the respective time zones.
Related Links
Sample Request
Copiedcurl --location --request GET 'https://www.zohoapis.com/bookings/v1/json/services?workspace_id= 3848021000000027083' \
--header 'Authorization: Zoho-oauthtoken 1000.7b3610d1XXXXXXXXXXXXXXXX087cc3.6282226f615637c467bee7209ce1c0a1'
Sample Response
Copied{
"response": {
"returnvalue": {
"data": [
{
"duration": "5 mins",
"buffertime": "0 mins",
"service_type": "APPOINTMENT",
"price": 0,
"assigned_staffs": [
"132513000000038018",
"132513000000114006",
"132513000000114016",
"132513000000114038",
"132513000000114048",
"132513000000114060"
],
"name": "service",
"let_customer_select_staff": true,
"description": "",
"currency": "USD",
"id": "132513000000038056"
},
{
"duration": "10 mins",
"buffertime": "0 mins",
"service_type": "RESOURCE",
"price": 0,
"assigned_staffs": [],
"name": "Resource",
"let_customer_select_staff": true,
"description": "",
"currency": "USD",
"id": "132513000000116022"
},
{
"duration": "5 mins",
"buffertime": "0 mins",
"service_type": "CLASS",
"price": 0,
"assigned_staffs": [
"132513000000114016"
],
"name": "grp",
"let_customer_select_staff": true,
"description": "",
"currency": "INR",
"id": "132513000000123116"
},
{
"duration": "10 mins",
"buffertime": "0 mins",
"service_type": "COLLECTIVE",
"price": "0",
"assigned_groups": [
{
"id": 132513000000142038,
"staffs": [
"132513000000114016",
"132513000000114060"
]
},
{
"id": 132513000000142040,
"staffs": [
"132513000000038018",
"132513000000114006",
"132513000000114016",
"132513000000114060"
]
}
],
"name": "collective",
"let_customer_select_staff": true,
"description": "",
"currency": "INR",
"id": "132513000000139002"
}
]
},
"status": "success"
}
}