​

Fetch Staff

Table of Contents

Purpose

​To fetch the staff details.

Request URL

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

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 in the request body as form-data along with the request URL are,

Parameter NameDescription

staff_id

(optional)

The unique id of the staff which must be fetched.

service_id

(optional)

The unique id if the service which must be fetched.

staff_email

(optional)

Unique email address of the staff whose details must be fetched. 
Note: This parameter is fetched based on 'contains' logic and not 'equal to' logic. That is, staff emails are searched if the passed value is present rather than requiring an exact match.

​  

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/staffs?staff_id={{staff_id}}&service_id={{service_id}}' \
--header 'Authorization: Zoho-oauthtoken 1000.7b3610d1XXXXXXXXXXXXXXXX087cc3.6282226f615637c467bee7209ce1c0a1' \

Sample Response

Copied{
    "response": {
        "returnvalue": {
            "data": [
                {
                    "additional_information": "Responsible for handling customer inquiries about product features and configurations.",
                    "assigned_services": [
                        "78386000000195002",
                        "78386000000366030",
                        "78386000000795204",
                        "78386000000796172",
                        "78386000000860002",
                        "78386000000349052",
                        "78386000000887032",
                        "78386000000032056"
                    ],
                    "name": "Maria Alice",
                    "photo": "https://zylker.com/user-profiles/maria-alice.jpeg",
                    "designation": "Support Agent",
                    "id": "78386000000032018",
                    "email": "maria.alice@zylker.com"
                },
      ]
    },
    "status": "success"
  }
}