/v1/appointment/book/service/list

Retrieves the list of appointment services that can be booked for a given business location and region in UAT. Use this to drive the service-selection step in the booking flow (before choosing staff, assets, or timeslots).

Method: GET

Base URL (UAT): https://uat-api.wellnessliving.io/v1/appointment/book/service/list

Query Parameters

id_region (required, integer)

Region identifier for the deployment (e.g., 1, 2).

Controls which regional configuration and catalog are used.

k_business (required, integer/string)

WellnessLiving business ID.

Ensures services are scoped to the correct business (BID).

k_location (required, integer/string)

Location ID within the business.

Filters services to those offered at the specified location.

Authentication

In UAT, this request typically requires a valid auth token (e.g., TOKEN) sent via the configured collection/request auth mechanism.

Response Overview (200)

Returns a JSON object with an a_service map keyed by service IDs. Each entry contains service configuration and display data, for example:

{
  "a_service": {
    "235076": {
      "k_service": "235076",
      "k_service_category": "48627",
      "s_service": "Service name",
      "s_duration": "1h",
      "i_duration": 60,
      "i_capacity": "10",
      "f_offline_min": "20.00",
      "f_offline_max": "20.00",
      "f_online": "0.00",
      "i_price": 1,
      "is_bookable": true,
      "is_virtual": false,
      "is_resource_type": false,
      "a_image": {
        "s_url": "https://...",
        "i_width": 200,
        "i_height": 200
      },
      "html_description": "<p class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Long description...</p>",
      "html_description_short": "Short description...",
      "is_wait_list_unpaid": true,
      "is_multiple_booking": "1"
    }
  }
}

Key fields per service (non-exhaustive):

Identification & grouping

k_service – unique service ID.

k_service_category – category/group this service belongs to.

Booking & availability

is_bookable (boolean) – whether the service is currently available for online booking.

i_capacity (string/int) – max number of clients per timeslot.

is_multiple_booking – whether multiple clients can be booked in a single timeslot.

is_wait_list_unpaid – whether unpaid waitlist is supported.

is_staff_confirm / is_staff_skip – staff confirmation / selection behavior.

Pricing & duration

s_duration, i_duration, i_duration_real – formatted and numeric duration.

f_offline_min, f_offline_max – offline price range.

f_online – online price; combined with i_price to determine pricing behavior.

f_deposit, is_deposit_percent – deposit configuration.

Virtual & resources

is_virtual – true if service is virtual/online.

is_resource_type – true if an asset/resource is required/represented.

Content & display

s_service – service display name.

html_description / xml_description – full description.

html_description_short / xml_description_short – short description.

a_image – primary image metadata and URLs (view and thumbnail).

UAT Usage Notes

Use known UAT IDs for id_region, k_business, and k_location (for example, the BID and location configured for this UAT collection) to ensure non-empty results.

Response content (names, prices, images, descriptions) is UAT/demo data and may change; do not rely on exact values, only on field structure and types.

This endpoint is typically called after authentication and service-category selection, and before staff/time selection in the appointment booking flow.

For automated tests, assert on structural fields (presence of a_service, k_service, is_bookable, is_virtual, etc.) rather than specific IDs or text values.

/v1/appointment/book/service/list