탐색으로 건너뛰기

Get All Services

Get all services for the current workspace with optional filters

헤더

xi-api-keystring선택 사항
xi-workspace-idstring or null선택 사항
The customer workspace a reseller's API key acts on.

쿼리 매개변수

staff_idstring or null선택 사항
asset_idstring or null선택 사항
is_activeboolean or null선택 사항
kindenum or null선택 사항기본값 classic

What a service books.

  • classic: a staff-delivered service (haircut, consultation, massage, …).
  • rental: an asset reservation (court, room, equipment).
  • group: seats in a multi-participant session (class, workshop, tour).
허용된 값:

응답

성공 응답

namestring
variantslist of objects
_idstring
duration_minutesinteger읽기 전용
Duration of the first variant.
pricedouble or null읽기 전용
Price of the first variant.
pricing_modeenum선택 사항기본값 fixed

‘fixed’ (default): the item has a known price the agent can quote, and customers can book or order it directly. ‘quote’: the price depends on the job (renovation, catering, custom work), so no price or slot is offered; the agent collects the intake_questions and files a quote request instead. Takes effect only while quotes are enabled for the business. Group services cannot use ‘quote’.

허용된 값:
intake_questionslist of objects선택 사항

Questions the agent asks before booking or ordering this item. Required for a useful pricing_mode='quote' item — without them a quote request arrives with nothing to price — but also valid on fixed-price items that need extra detail (current hair color before a dye job, allergies before a treatment).

groupslist of objects선택 사항

Group memberships for this item. Each entry carries the group label and the item’s 0-based rank within that group.

ungrouped_rankinteger or null선택 사항>=0

Display position among items with no group; null sorts last. Change it with the reorder endpoint.

descriptionstring선택 사항
kindenum선택 사항기본값 classic

Classic = staff-delivered; rental = asset-based; group = multi-participant session.

허용된 값:
buffer_minutesinteger선택 사항0-1440기본값 0

Turnover/cleanup time reserved after each booking. Applies to every service kind; default 0 means no buffer.

service_locationenum선택 사항기본값 business

Where the service is delivered. business = client visits the business location (default); customer = staff travels to the client. Only meaningful for kind='classic'.

허용된 값:
add_onslist of objects선택 사항
Optional extras that can be added to a booking of this service.
max_participantsinteger or null선택 사항2-200

Capacity for kind='group': how many seats a single session can sell across all registrations. Must be null for classic and rental services (those are always exclusive to one client per booking).

capacityinteger or null선택 사항
is_activeboolean선택 사항기본값 true
any_staff_memberboolean선택 사항기본값 true
staff_idslist of strings선택 사항

Staff assigned to this service; must be empty for kind=‘rental’.

asset_idslist of strings선택 사항
advance_booking_minutesinteger선택 사항0-525600기본값 1440

How far into the future customer-facing channels (public booking page, voice agent) may book this service. Applies to every kind.

location_idslist of strings선택 사항

Locations where this service is offered; empty list means all locations.

display_on_booking_pageboolean선택 사항기본값 true
travel_minutesinteger선택 사항0-480기본값 0

Travel time in minutes added before/after appointments for customer-location services. Blocks the staff member’s calendar but is not visible to the customer. Ignored when service_location='business'.

travel_beforeboolean선택 사항기본값 true

Add travel time before the appointment (outbound trip).

travel_afterboolean선택 사항기본값 true

Add travel time after the appointment (return trip).

promotionslist of objects선택 사항

Time-bound discounts applicable to this service or specific variants.

created_at_unixinteger선택 사항

Unix timestamp (seconds since epoch)

updated_at_unixinteger선택 사항

Unix timestamp (seconds since epoch)

오류

422
Unprocessable Entity Error