/v1/appointment/book/asset/category

Retrieve the list of bookable asset categories for appointments in a specific WellnessLiving business/location.

Purpose

Use this endpoint to fetch asset categories (e.g., rooms, equipment, or resource groupings) that can be booked for appointments. The response includes category titles and the corresponding k_resource_type values needed for subsequent booking calls.

HTTP Request

GET /v1/appointment/book/asset/category

Base URL (UAT example): https://uat-api.wellnessliving.io

Authentication

This request requires a valid internal token sent via the x-internal-key header.

In Postman, ensure your authentication/variables are set up so that this header is included on each call.

Required Query Parameters

id_region (integer) – Data center/region identifier.

Known values (examples): 1, 2.

k_business (integer) – Business (account) key whose appointment asset categories you want to retrieve.

Example values: 49197, 50217.

k_location (integer) – Location key within the business.

Example values: 315968, 5000000248.

Example request:

Successful Response (200 OK)

On success, the endpoint returns a JSON payload containing an array of categories under a_category, along with status metadata.

Example (truncated) response:

{
  "a_category": [
    {
      "hide_application": false,
      "html_title": "Barbiesco Changed",
      "text_title": "Barbiesco Changed",
      "k_resource_type": "10743"
    },
    {
      "hide_application": false,
      "html_title": "Three DDD Changed",
      "text_title": "Three DDD Changed",
      "k_resource_type": "100000000769"
    },
    {
      "hide_application": false,
      "html_title": "New Category",
      "text_title": "New Category",
      "k_resource_type": "100000000837"
    }
  ],
  "status": "ok",
  "s_version": "444085",
  "__a_message": [
    "Age restriction status is incorrect.|wl....<truncated>",
    "Ages: [i_from]-[i_to]|Wl.Service.AgeRest...<truncated>"
  ]
}

Key Fields

a_category[] – List of asset categories.

hide_application (boolean) – Indicates whether the category should be hidden in the application.

html_title (string) – HTML-safe display title.

text_title (string) – Plain-text display title.

k_resource_type (string) – Resource type key used when creating bookings.

status (string) – Request status, e.g., "ok".

s_version (string) – Internal version identifier.

__a_message (array) – Additional diagnostic or informational messages, often related to age restrictions.

Use the k_resource_type values from a_category when constructing follow-up appointment booking requests.

curl --location -g --request GET '/v1/appointment/book/asset/category?id_region={{id_region}}&k_business={{k_business}}&k_location={{k_location}}' \ --header 'Content-Type: text/plain' \ --data-raw ''

Purpose#

HTTP Request#

Authentication#

Required Query Parameters#

Successful Response (200 OK)#

Key Fields#