List all employees of a center

GET https://api.zenoti.com/v1/centers/{center_id}/employees

This API helps you to retrieve all the employees that are active in the center on the specified date.

You must specify the unique identifier of the center as center_id in the API request. You can also use the pagination feature by passing page and size query parameters if you have a large number of records to be displayed. By default, page is set as 1 and size is set as 10. size cannot be more than 100: which means that the maximum records per page cannot be more than 100.

Before you begin

Permission: Manage API Keys (on the Administrator security object) — Required to access Zenoti APIs.

Endpoint

GET /v1/centers/{center_id}/employees

Base URL: https://api.zenoti.com

Request

Headers

Header Required Description
Authorization Yes bearer {{access_token}}

Path parameters

Parameter Type Required Description
center_id string Yes Mandatory Unique 32-character identifier of the center.

Query parameters

Parameter Type Required Default Description
date string (date) No — Optional Date on which the employees are to be listed.
page integer (int32) No 1 Optional Number of the display page. Default value is 1.
size integer (int32) No 10 Optional Number of records per page. Default value is 10.

Response

Success (200 OK)

{
  "employees": [
    {
      "...": "..."
    }
  ]
}

Response fields

Field Type Description
employees object[]
employees[].id string
employees[].code string
employees[].personal_info object
employees[].job_info object

Example

curl --request GET \
  --url 'https://api.zenoti.com/v1/centers/{center_id}/employees' \
  --header 'Authorization: bearer {{access_token}}'
const response = await fetch('https://api.zenoti.com/v1/centers/{center_id}/employees', {
  method: 'GET',
  headers: {
    'Authorization': 'bearer {{access_token}}'
  },
});
const data = await response.json();
import requests

response = requests.get(
    'https://api.zenoti.com/v1/centers/{center_id}/employees',
    headers={
        'Authorization': 'bearer {{access_token}}',
    },
)
data = response.json()
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "bearer {{access_token}}");
var response = await client.GetAsync(
    "https://api.zenoti.com/v1/centers/{center_id}/employees");
var data = await response.Content.ReadAsStringAsync();
require 'net/http'
require 'json'

uri = URI('https://api.zenoti.com/v1/centers/{center_id}/employees')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'bearer {{access_token}}'
response = http.request(request)
data = JSON.parse(response.body)

Error codes

Status Description
400 400
401 Unauthorized -- invalid or expired access token
429 Too many requests -- rate limit exceeded