WellnessLiving API (UAT) - v1.2026-02
  1. promotion
WellnessLiving API (UAT) - v1.2026-02
  • WellnessLiving API - [Feb-2026]
  • Auth
    • Authentication
  • appointment
    • /v1/appointment/book/asset/category
    • /v1/appointment/book/asset/list
    • /v1/appointment/book/asset/service
    • /v1/appointment/book/finish
    • /v1/appointment/book/finish
    • /v1/appointment/book/payment/paymentPost
    • /v1/appointment/book/product
    • /v1/appointment/book/schedule/calendar
    • /v1/appointment/book/schedule/day-time
    • /v1/appointment/book/service/category
    • /v1/appointment/book/service/list
    • /v1/appointment/book/staff/list
  • book-process
    • /v1/book/process/info
    • /v1/book/process/payment
    • /v1/book/process/purchase
    • /v1/book/process/purchase/element/list
  • business-data
    • /v1/business
    • /v1/business/franchise/location
    • /v1/business/skin
  • catalog
    • /v1/catalog/list
    • /v1/catalog/staff/catalog/list
  • classes
    • /v1/classes/list
    • /v1/classes/promotion
    • /v1/classes/view/element
  • collector-debt
    • /v1/collector/debt/list
    • /v1/collector/debt/pay
    • /v1/collector/debt/transaction
  • drive
    • /v1/drive/product/image/upload
  • ecommerce
    • /v1/ecommerce/order/sync
  • event
    • /v1/event/book/list
    • /v1/event/book/view/element
    • /v1/event/list
  • lead
    • /v1/lead/info
    • /v1/lead/info
  • location
    • /v1/location/list
    • /v1/location/view
  • login
    • /v1/login/attendance/list
    • /v1/login/search/settings
    • /v1/login/search/settings
    • /v1/login/search/staff-app/list
  • member
    • /v1/member/info
  • profile
    • /v1/profile/contract
    • /v1/profile/create
    • /v1/profile/fields
    • /v1/profile/purchase/list
    • /v1/profile/purchase/list/element
  • promotion
    • /v1/promotion
      GET
    • /v1/promotion/list
      GET
  • purchase
    • /v1/purchase/receipt
  • report
    • /v1/report/data
    • /v1/report/query
  • report-dev
    • /v1/report/customization-form
    • /v1/report/filter-info
  • schedule
    • /v1/schedule/class/list
    • /v1/schedule/class/view
    • /v1/schedule/class/view
    • /v1/schedule/page/element
    • /v1/schedule/page/list
    • /v1/schedule/tab
  • shop
    • /v1/shop/category
  • staff
    • /v1/staff/list
    • /v1/staff/view
  • user
    • /v1/user
  • visit
    • /v1/visit/status
  1. promotion

/v1/promotion/list

GET
/v1/promotion/list

Description#

Retrieves the list of active promotions available for a specific business and region.

HTTP Request#

GET https://uat-api.wellnessliving.io/v1/promotion/list

Query Parameters#

id_region (integer, required): Region identifier. Example: 2.
k_business (integer, required): Business key/identifier. Example: 49197.
uid (integer, required): Client/user identifier within the business. Example: 2720946.

Authentication#

Uses the TOKEN variable (e.g., as a header or auth scheme) to authorize the request.

Successful Response (200 OK)#

The response body contains a JSON object with the following top-level fields:
a_promotion (array): List of promotions available to the specified client in the given business and region.
id_program (integer): Program identifier associated with the promotion.
is_active (string/boolean-like): Indicates whether the promotion is active ("1" for active).
k_promotion (string): Unique promotion key/ID.
text_title (string): Human-readable promotion name/title.
id_program_type (integer): Program type identifier (e.g., class/event membership, appointment pass).
status (string): Request status. Expected value: "ok" on success.
s_version (string): API version or response schema version identifier.

Notes#

Only promotions where is_active = "1" are expected in this response.
Use k_promotion to reference a specific promotion in subsequent operations, if required.

Request

Query Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/v1/promotion/list?id_region={{id_region}}&k_business={{k_business}}&uid={{uid}}' \
--header 'Content-Type: text/plain' \
--data-raw ''
Response Response Example
{}
Modified at 2026-02-26 17:13:05
Previous
/v1/promotion
Next
/v1/purchase/receipt
Built with