Use center APIs
The center APIs let you retrieve information about centers (locations), including center details, categories, rooms, employees, services, packages, products, and memberships at the center level. These APIs are foundational for most integration workflows because you need center data before you can create bookings, generate invoices, or manage guests.
For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.
On this page
- Before you begin
- Centers
- Categories
- Rooms
- Employees and therapists
- Services
- Packages, products, and memberships
- Related articles
Before you begin
- You need a valid API key or access token. See Set up API authentication.
Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.
Centers
List all centers
GET /v1/centers
Retrieves all centers in your organization with optional pagination and data expansion.
| Parameter | Type | Required | Description |
|---|---|---|---|
| expand | string | No | Include additional data (for example, working_hours, all_catalog) |
| page | integer | No | Page number (default: 1) |
| size | integer | No | Records per page (default: 10, max: 100) |
Response: centers (array of center objects), page_info (pagination metadata), error.
Each center object includes id, code, name, display_name, country and state information, geographic location and timezone, currency settings, address and contact info, and working hours (when expanded).
Retrieve a center
GET /v1/centers/{center_id}
Retrieves detailed information about a specific center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Unique identifier of the center |
Response: Center details including id, name, code, phone, time_zone_id, currency_id, email.
Deactivate or disable a center
PUT /v1/centers/deactivate_center
Deactivates a center in the organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | string | Yes | Unique identifier of the center to deactivate |
| organization_id | string | Yes | Organization identifier |
| account_name | string | Yes | Account name associated with the center |
| churn_reason | string | Yes | Reason for deactivation |
Categories
List all categories
GET /v1/centers/{center_id}/categories
Retrieves all active categories within a center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | string | Yes | Unique identifier of the center |
Response: categories (array of category objects), page_info, error.
Retrieve a category
GET /v1/centers/{center_id}/categories/{category_id}
Retrieves details of a specific category.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| category_id | guid | Yes | Category identifier |
Response: id, code, name, parent_category_id, description, html_description, show_in_catalog, display_order.
Rooms
List all rooms of a center
GET /v1/centers/{center_id}/rooms
Retrieves all active rooms within a center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | string | Yes | Center identifier |
| page | integer | No | Page number (default: 1) |
| size | integer | No | Records per page (default: 10, max: 100) |
Response: rooms (array of room objects), error.
Retrieve a room of a center
GET /v1/centers/{center_id}/rooms/{room_id}
Retrieves details of a specific room.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | string | Yes | Center identifier |
| room_id | string | Yes | Room identifier |
Response: id, code, name, room_category_id, description, capacity, can_exceed_capacity, only_one_appointment.
Employees and therapists
List all employees of a center
GET /v1/centers/{center_id}/employees
Retrieves all active employees at a center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| page | integer | No | Page number (default: 1) |
| size | integer | No | Records per page (default: 10, max: 100) |
Response: employees (array with id, code, personal_info, first_name, last_name, gender), job_info, page_info.
List all therapists of a center
GET /v1/centers/{center_id}/therapists
Retrieves all active therapists at a center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | string | Yes | Center identifier |
| expand | string | No | Related entities to expand |
| search_text | string | No | Filter by employee name |
Response: therapists (array with personal_info, job_details).
List all blockout times of a center
GET /v1/centers/{center_id}/blockouttimes
Retrieves blockout times for employees and rooms between specified dates.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| start_date | datetime | Yes | Start date for retrieval |
| end_date | datetime | Yes | End date for retrieval |
Response: block_out_times (array with block_out_time_id, employee, room, start_time, end_time, notes, recurring schedule details).
Center attendance for a date
GET /v1/centers/{center_id}/attendance?date={date}
Retrieves employee attendance records for a specific date.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| date | datetime | Yes | Date for attendance retrieval |
Response: Array with employee_id, date, expected_check_in_time, expected_check_out_time, actual_check_in_time, actual_check_out_time.
Retrieve employee schedules
GET /v1/centers/{center_id}/employee_schedules
Retrieves employee schedules for a center. Requires the Schedule permission enabled under Organization > Security Roles > Employee Manager > Other Settings.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| start_date | datetime | Yes | Schedule start date |
| end_date | datetime | Yes | Schedule end date |
| employee_id | guid | No | Filter by specific employee |
| job_id | guid | No | Filter by job |
Response: employee_schedules (array with employee_id, employee_name, schedules containing date, shifts with schedule_id, start_time, end_time, status, room_id).
Services
List all services of a center
GET /v1/centers/{center_id}/services
Retrieves all active services at a center.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| expand | string | No | Comma-separated: additional_info, catalog_info, category_id, variants_info, add_ons_info, image_paths, tags |
| category_id | string | No | Filter by category |
| page | integer | No | Page number (default: 1) |
| size | integer | No | Records per page (default: 10, max: 100) |
Response: Array of services with id, code, name, description, duration, recovery_time, price_info (sale_price, tax, final_price), and expanded fields when requested.
Retrieve a service of a center
GET /v1/centers/{center_id}/services/{service_id}
Retrieves details of a specific service.
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| service_id | guid | Yes | Service identifier |
| expand | string | No | Same expand options as list endpoint |
Response: Full service details including is_couple_service, parallel_service_groups, prerequisites_info, finishing_services_info.
Packages, products, and memberships
List all packages of a center
GET /v1/centers/{center_id}/packages
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| page | integer | No | Page number |
| size | integer | No | Records per page |
Response: packages (array with id, code, name, type (day/series/promo), active, centers, benefits), page_info.
List all products of a center
GET /v1/centers/{center_id}/products
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
| page | integer | No | Page number |
| size | integer | No | Records per page |
Response: products (array with id, code, name, sale_price, desired_quantity, alert_quantity), commissions, inventory_info, page_info.
List all memberships in a center
GET /v1/centers/{center_id}/memberships
| Parameter | Type | Required | Description |
|---|---|---|---|
| center_id | guid | Yes | Center identifier |
Response: memberships (array with id, version_id, name, price, display_name, is_recurring_membership, membership_type (0=Non-recurring, 1=Recurring, 2=Setup), payment_frequency, description, terms_and_conditions), total_no_of_memberships.