Loyalty tiers
Get all loyalty tiers
Returns all loyalty tiers of the chain or chains, filtered by loyalty program identifiers and optionally filtered by specific loyalty tier identifiers, activity states, or other filter parameters. Note this operation uses Pagination and supports Portfolio Access Tokens.
Request
[PlatformAddress]/api/connector/v1/loyaltyTiers/getAll
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ChainIds
array of string
optional, max 1000 items
Unique identifiers of the chain. If not specified, the operation returns data for all chains within scope of the Access Token.
ActivityStates
array of string Activity state
optional
Whether to return only active, only deleted or both records.
Response
Cursor
string
optional
Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.
Loyalty tier
Id
string
required
Unique identifier of the loyalty tier.
ChainId
string
optional
Unique identifier of the chain.
LoyaltyProgramId
required
required
Unique identifier of the loyalty program of that loyalty tier.
Name
string
required
Name of the loyalty tier.
Code
string
required
Code of the loyalty tier.
Ordering
number
required
Ordering of the loyalty tier.
Add loyalty tiers
Adds loyalty tiers to a loyalty program of the enterprise chain. Note this operation supports Portfolio Access Tokens.
Request
[PlatformAddress]/api/connector/v1/loyaltyTiers/add
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
ChainId
string
optional
Unique identifier of the chain. Required when using Portfolio Access Tokens, ignored otherwise.
Loyalty tier parameters
LoyaltyProgramId
string
required
Unique identifier of the loyalty program the tier belongs to.
Name
string
required, max length 50 characters
Name of the loyalty tier.
Code
string
required, max length 50 characters
Code of the loyalty tier.
Ordering
number
required
Ordering of the loyalty program.
Response
Update loyalty tiers
Updates information about the specified loyalty tiers.
Request
[PlatformAddress]/api/connector/v1/loyaltyTiers/update
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
LoyaltyTierUpdates
array of Loyalty tier update parameters
required, max 1000 items
Loyalty tiers to be updated.
Loyalty tier update parameters
LoyaltyTierId
string
required
Unique identifier of the loyalty tier.
Name
optional, max length 50 characters
Name of the loyalty tier (or null
if the name should not be updated).
Code
optional, max length 50 characters
Code of the loyalty tier, (or null
if the code should not be updated).
Ordering
optional
Ordering of the loyalty tier, (or null
if the ordering should not be updated).
Response
Delete loyalty tiers
Deletes loyalty tiers.
Request
[PlatformAddress]/api/connector/v1/loyaltyTiers/delete
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
LoyaltyTierIds
array of string
required, max 1000 items
Unique identifier of the loyalty tiers to be deleted.
Response
Last updated