LuckySoft

LuckyFit Public Integration API

Leads

Create a lead (inquiry)

Info sources

List information sources

Memberships

Membership catalog (assortment available for sale)

List access segments

Addons

Addons available for a membership

Addons purchased on a client's membership

Purchase an addon for a client's membership

Clients

Search clients

Create a client

Update a client

Delete a client

Client memberships

Client's memberships

Sell a membership to a client

Create a client and sell a membership

Validate a promocode / promo-action code

Pay off membership debt

Organizations

List network branches

Terminal

Look up clients by phone number

Top up a client's deposit

Accounting

Export transactions for a period

LuckyFit API

1.0.6 Local development (Docker)

Production

Checks whether `code` is a currently valid promocode or promo-action
code for the given client and membership plan. The lookup applies the
same rules used when selling a membership:

- the code must be active (current time within the action's
  `start`/`finish` window);
- per-client / one-time codes (`code_kind = 1`) are rejected if the
  client has already used them;
- if the action restricts to membership segments, the plan
  (`ticket_id`) must match one of those segments;
- codes tied to goods (`goods` set) are not valid for memberships.

On success the `data` field holds the matching promo-action (with the
resolved `code`); when the code is invalid `data` is `null` while
`success` stays `true`. The returned `promoaction_id` / `code` can then
be passed to `POST /clients/{client_id}/memberships`.


Api-Key

client_id

Promocode or promo-action code to validate.

code

Catalog membership ID the code is being applied to.

ticket_id

success

A promo-action (discount campaign). Returned by the promocode check
endpoint as the raw record; its `id` / `code` can be applied when
selling a membership.


data

error

error_code

total

summary

Validation result (crud envelope). Note: `data` is the single
promo-action object (not an array), or `null` when the code is
invalid — `success` stays `true` either way.


session_expired

Unauthorized

Promo-action ID (use as `promoaction_id` when selling).

Network (root organization) the action belongs to.

organization_id

name

start

finish

discount

discount_kind

Code usage kind. `1` — per-client / one-time (rejected once the
client has used it); `0` — general code.


code_kind

The matched promocode / promo-action code.

JSON array of membership segment IDs the action is limited to (null = no restriction).

segments

JSON of goods the action targets (set only for goods-bound actions, which are not valid for memberships).

Sections

Validate a promocode / promo-action code

Header Parameters

Query Parameters

Path Parameters

Response

Response Attributes

Response Attributes

Response

Sections

Validate a promocode / promo-action code

Header Parameters

Query Parameters

Path Parameters

ResponseExpand all

Response Attributes

Response Attributes

Response

Ask an AI

Code with AI

Response