Fetch Services

 

Purpose

​To fetch all services under a workspace.

 

Request URL

https://www.zohoapis.com/bookings/v1/json/services

 

Headers

Parameter NameDescription
AuthorizationZoho-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 NameDescription
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/EditionNumber of API calls/day
Free250/per user
Basic1000/per user
Premium3000/per user
Zoho One3000/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"
    }
}