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

GET
/v1/promotion

Summary#

Retrieves details for a specific promotion in the WellnessLiving UAT environment. This includes metadata, access rules, imagery, pricing, duration, and flags such as whether the promotion is available for online purchase.

Parameters#

NameLocationTypeRequiredDescription
id_regionQueryintYesRegion identifier for the business location (e.g., geographic/market region).
k_businessQueryint/stringYesUnique business key in WellnessLiving. Identifies which business the promotion belongs to.
uidQueryint/stringYesUser identifier for whom the promotion context is being retrieved (e.g., client account).
k_promotionQueryint/stringYesUnique key of the promotion to retrieve details for.

Authentication#

This endpoint is typically secured. Ensure a valid bearer token is provided, for example using a variable such as {{TOKEN}}/{{token}} in the Authorization header:

Response (200 OK)#

On success, the response body includes a top-level a_promotion object and supporting metadata (e.g., status, s_version). Key fields within a_promotion include:
a_access: Access rules for the promotion, including arrays like a_class, a_event, a_resource, a_service, and flags is_class_all / is_event_all.
a_image: Image metadata and URLs (height, width, thumbnail, view URL, etc.).
m_price: Monetary price of the promotion.
i_duration, id_duration, id_duration_type: Duration value and type (e.g., days, weeks, months).
id_program: Program/type identifier for the promotion.
is_introductory, is_online: Flags indicating introductory status and online availability.
text_title, text_description: Human‑readable title and description of the promotion.
url_buy: URL for purchasing the promotion online, when applicable.
The status field (e.g., "ok") and s_version help confirm a successful response and the API version in use.

Request

Query Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/v1/promotion?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/profile/purchase/list/element
Next
/v1/promotion/list
Built with