Skip to main content
GET
Get a promotion

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Path Parameters

id
integer
required

1club promotion id

Response

The promotion

promotionId
integer
name
string

What members see beside the discounted price

description
string | null
type
enum<string>

discount comes off what is bought; voucher is an amount the member keeps as credit

Available options:
discount,
voucher
discountFormat
enum<string> | null

A discount's form; null on a voucher, whose value is an amount

Available options:
percent,
amount,
null
value
number

The percentage off, or the amount in the organization's currency

code
string | null

The promo code a member types; null when there is none

autoApply
boolean

Applies itself at checkout, without a code

startsAt
string<date-time> | null
endsAt
string<date-time> | null
status
enum<string>

Where the promotion is in its date range now

Available options:
scheduled,
live,
ended
redemptionCount
integer

How many times it has been redeemed

maxRedemptions
integer | null

The most it may be redeemed in all; null for no limit

maxRedemptionsPerContact
integer | null

The most one member may redeem it; null for no limit

visibility
enum<string>

Who sees it offered. Defaults to Public

Available options:
Public,
Member_only,
Private
validFor
object

What it applies to. Bookings qualify through scopes, narrowed by the type ids and clubIds (empty = every one). A plan purchase qualifies only when named in planIds, or with allPlans.

segmentFilter
object

Who it is for: a buyer must match every list sent. {} is everyone.

conditions
object

When a booking qualifies. Each condition judges the whole booking.

createdAt
string<date-time>
updatedAt
string<date-time>