POST reward_offers/get_applicable

Available from CRM.COM R14.3.0

For previous releases check the GET reward_offers/show (legacy) Web API

This method returns the reward offers that are applicable for a specific rewards participant. Multiple reward offers are returned by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

rewards_participant_identifier

(semi-optional)

Rewards participant identifier

The identifier of the rewards participant who might benefit from the reward offer that will be returned as a result. The allowed rewards participant identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the rewards participant

number

(semi-optional)

String

The number of the rewards participant

accounts_receivable_identifier

(semi-optional)

Accounts Receivable identifier

The identifier of the rewards participant's accounts receivable. The allowed accounts receivable identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the accounts receivable

number

(semi-optional)

String

The number of the accounts receivable

name

(semi-optional)

String

The name of the accounts receivable

access_token_identifier

(semi-optional)

Access Token Identifier

The identifier of the access token which is related with the accounts receivable. Only effective access tokens can be used to identify an accounts receivable. The allowed access token identifier fields are the following

Name	Type	Description
authentication_code (semi-optional)	String	The authentication code of the access token
identifier (semi-optional)	String	The identifier of the access token. If the identifier is specified then it will be validated against the specified pass code
pass_code (mandatory on conditions)	String	The pass code of the access token, which is applicable and mandatory if the identifier is specified
one_time_password (semi-optional)	Integer	The one-time password (OTP) of the access token Available from CRM.COM R13.0.0

Available from CRM.COM R8.0.0

Deprecated from CRM.COM R18.0.0

wallet_identifier

(semi-optional)

Wallet identifier

The identifier of the reward participant's wallet. The allowed wallet identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the wallet

number

(semi-optional)

String

The number of the wallet

group_identifier

(optional)

Group Identifier

The identifier of the group that will provide the reward offer. The group is filtered against the reward offer's Award conditions organisational units. The allowed unit identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the group

name

(semi-optional)

String

The code of the group

alternative_code

(semi-optional)

String

The alternative code of the group

unit_identifier

(optional)

Unit identifier

The identifier of the unit that will provide the reward offer. The unit is filtered against the reward offer's Award conditions organisational units. The allowed unit identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the Unit

name

(semi-optional)

String

The name of the Unit

alternative_code

(semi-optional)

String

The alternative code of the Unit

reward_scheme_identifier

(optional)

Reward scheme identifier

The identifier of the reward scheme related with the reward offer that should be returned as a result. The allowed reward scheme identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the reward scheme

name

(semi-optional)

String

The name of the reward scheme

alternative_code

(semi-optional)

String

The alternative code of the reward scheme

type_identifier
(optional)

Reward offer type identifier

The identifier of the reward offer type related with the reward offer that should be returned as a result. The allowed reward offer type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the reward offer type

name

(semi-optional)

String

The name of the reward offer type

alternative_code

(semi-optional)

String

The alternative code of reward offer type

evaluation_method

(optional)

Reward offer evaluation method identifier

The identifier of the reward offer evaluation method related with the reward offer that should be returned as a result. The allowed reward offer evaluation method identifier fields are the following:BATCH_PROCESS or BATCH_PROCESS_AND_INTERACTIVELY.

award_scope

(optional)

Award Scope identifier

The identifier of the award scope related with the reward offer that should be returned as a result. The allowed award scope identifier fields are the following: APPLY_AWARD_PER_TRANSACTION_ITEM or APPLY_AWARD_PER_TRANSACTION.

Available from CRM.COM R10.0.0

spend_method

(optional)

Reward Offer spend method

The identifier of the reward offer spend method related with the reward offer that should be returned as a result. The allowed reward offer spend method identifier fields are the following: SPEND_ON_REQUEST, SPEND_INSTANTLY or SPEND_INSTANTLY_THROUGH_VOUCHER

Available from CRM.COM R10.0.0

Spend instantly on voucher method available from CRM.COM R14.2.0

award_currency

(optional)

Currency Identifier

The identifier of the currency in which the reward offer will award rewards participants. The allowed currency identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the currency

code

(semi-optional)

String

The code of the currency

Available from CRM.COM R14.2.0

purchase_product

(optional)

Product identifier

The identifier of the product which the rewards participant will have to buy in order to benefit from the reward offer that will be returned as a result. The allowed product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of the product

purchase_product_type

(optional)

Product type identifier

The identifier of the product type which the rewards participant will have to buy in order to benefit from the reward offer that will be returned as a result. The allowed product type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product type

name

(semi-optional)

String

The name of the product type

alternative_code

(semi-optional)

String

The alternative code of a product type

purchase_product_family

(optional)

Product family identifier

The identifier of the family type which the rewards participant will have to buy in order to benefit from the reward offer that will be returned as a result. The allowed product family identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product family

name

(semi-optional)

String

The name of the product family

code

(semi-optional)

String

The code of a product family

purchase_product_brand

(optional)

Product Brand identifier

The identifier of the brand which the rewards participant will have to buy in order to benefit from the reward offer that will be returned as a result. The allowed product brand identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product brand

name

(semi-optional)

String

The name of the product brand

alternative_code

(semi-optional)

String

The alternative code of a product brand

Available from CRM.COM R15.0.0

purchase_product_category

(optional)

Product Category identifier

The identifier of the category type which the rewards participant will have to buy in order to benefit from the reward offer that will be returned as a result. The allowed product category identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product category

name

(semi-optional)

String

The name of the product category

code

(semi-optional)

String

The code of a product category

Available from CRM.COM R15.0.0

purchase_amount

(optional)

Number

The amount of the purchase that the rewards participant will have to make in order to benefit from the reward offer that will be returned as a result

number_of_purchases

(optional)

Number

The number of purchases that the rewards participant will have to make in order to benefit from the reward offer that will be returned as a result

number_of_results

(optional)

Number

The number of results that can be retrieved through each call

Available from CRM.COM R13.0.0

offset

(optional)

Number

Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number

Available from CRM.COM R13.0.0

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

As input parameters one of the following semi-optional parameters must be specified:
- rewards_participant_identifier
- accounts_receivable_identifier
- wallet_identifier
The rest of the input parameters are optional

Response Data

Name	Type	Description
id	String	The ID of the retrieved reward offer
number	String	The number of the retrieved reward offer
name	String	The name of the retrieved reward offer
alternative_code	String	The alternative code of the retrieved reward offer
description	String	The description of the retrieved reward offer
classification	String	The reward offer classification, which can be one of the following: UTILISE_FREE_CAPACITY INCREASE_REVENUE_TRANSACTION_BASED INCREASE_REVENUE_PRODUCT_BASED REWARD_LOYALTY_TRANSACTION_AMOUNT_BASED REWARD_LOYALTY_TRANSACTION_NUMBER_BASED REWARD_LOYALTY_TRANSACTION_ITEM_QUANTITY_BASED REWARD_SIGN_UPS REWARD_REFERRALS REWARD_PERSONAL_DATA_COMPLETENESS REWARD_ACHIEVEMENTS REWARD_FINANCIAL_STATEMENTS REWARD_SUBSCRIPTION_MATURITY JUST_MONEY LOTTERY XTH_TRANSACTION_WINS
evaluation_method	String	The method that will be used to evaluate the offers which can be BATCH_PROCESS or INTERACTIVELY
award_scope	String	The award scope that defines if the award provided by the reward offer should be applied per transaction or per transaction item, which can be APPLY_AWARD_PER_TRANSACTION or APPLY_AWARD_PER_TRANSACTION_ITEM Deprecated from CRM.COM R17.0.0
spend_method	String	The method that will be used to spend the offers which can be SPEND_ON_REQUEST, SPEND_INSTANTLY, SPEND_INSTANTLY_THROUGH_VOUCHER
apply_on_top_of_other_applicable_offers	Boolean	If false then the reward offer will be applicable only if the provided award is the best award among other reward offers that might be applicable. If true then it will be applied irrespective of any other applicable reward offers Deprecated from CRM.COM R17.0.0
life_cycle_state	String	The life cycle state of the retrieved lead which can be EFFECTIVE or NOT EFFECTIVE
latest_effective_date	Date	The latest effective date of the retrieved reward offer
latest_evaluation_date	Date	The latest date that the reward offer was evaluated. This is applicable only for reward offers with evaluation method equal to BATCH
terms_and_conditions	String	The terms and conditions for the retrieved reward offer Available from CRM.COM R15.0.0
award_amount	Number	The awarded amount provided by the reward offer. An awarded amount can be specified in all reward offers classifications. Either an awarded amount, award percentage or award percentage on awarded purchases is returned per reward offer.
award_percentage	Number	The award percentage of the financial transaction amount that triggered the award. Either an awarded amount, award percentage or award percentage on awarded purchases is returned per reward offer. An offer's awarded percentage can only be specified in the offer is classified as: UTILISE_FREE_CAPACITY, INCREASE_REVENUE_TRANSACTION_BASED, INCREASE_REVENUE_PRODUCT_BASED, REWARD_LOYALTY_TRANSACTION_AMOUNT_BASED and REWARD_LOYALTY_TRANSACTION_ITEM_QUANTITY_BASED
award_percentage_on_previous_awards	Award Percentage on Previous Awards Object	The award percentage on awards submitted within a specific period of time. Award percentage on previous awards can be specified in all reward offers classifications. Available from CRM.COM R10.0.0
award_currency	Currency Object	The currency in which the Reward Offer's award will be provided which can either be in system or the alternative currency.
reward_scheme	Reward Scheme Object	The reward scheme of the retrieved reward offer
category	Reward Offer Category Object	The category information of the retrieved reward offer
owned_by_group	Group object	The group that is owning the reward offer Deprecated from CRM.COM R18.0.0 (replaced with owned_by_business_unit)
owned_by_business_unit	Business Unit Object	The business unit that is owning the accounts receivable Available from CRM.COM R18.0.0
marketing_information	Reward Offer Marketing Information Object	The reward offer's marketing information
log_information	Log Information Object	The log information related with the retrieved reward offer

Referred Objects Response Data

currency object response data

Name	Type	Description
id	String	The ID of the retrieved currency
code	String	The code of the retrieved currency
prefix_symbol	String	The prefix symbol for the specified currency
suffix_symbol	String	The suffix symbol for the specified currency
life_cycle_state	String	The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0
integer_part_name	String	The integer part name for the specified currency
decimal_part_name	String	The decimal part name for the specified currency

reward scheme object response data

Name	Type	Description
id	String	The ID of the retrieved reward scheme
name	String	The name of the retrieved reward scheme
alternative_code	String	The alternative code of the retrieved reward scheme
description	String	A description of the retrieved reward scheme
life_cycle_state	String	The life cycle state of the reward scheme which can be EFFECTIVE or NOT_EFFECTIVE

award percentage on key performance indicator values response data

Name	Type	Description
percentage	Number	Defines the award percentage that should be applied on the value of the specified key performance indicator
key_performance_indicator	Key Performance Indicator Objects	The key performance indicator that will be awarded based on its value and the specified percentage

key performance indicator object response data

Name	Type	Description
id	String	The id of the retrieved customer event key performance indicator
name	String	The name of the retrieved customer event key performance indicator
alternative_code	String	The alternative code of the retrieved customer event key performance indicator

reward_offer_category data object

Name	Type	Description
id	String	The ID of the retrieved reward offer category
name	String	The Name of the retrieved reward offer category
code	String	The Code of the retrieved reward offer category
description	String	The Description of the retrieved reward offer category
parent_id	String	The id of the retrieved category's parent category

group object response data

Name	Type	Description
id	String	The ID of the retrieved group
name	String	The name of the retrieved group
community_name	String	The name of the community that the retrieved group belongs to
alternative_code	String	The alternative code of the retrieved group
unified_code	String	The unified code of the retrieved group Available from CRM.COM R16.2.2
description	String	The description of the retrieved group

business unit object response data

Name	Type	Description
id	String	The ID of the retrieved business unit
name	String	The name of the retrieved business unit
code	String	The code of the retrieved business unit
unified_code	String	The unified code of the retrieved business unit
description	String	The description of the retrieved business unit
parent_business_unit_name	String	The name of the parent business unit that the retrieved business unit belongs to

reward offer marketing information object response data

Name	Type	Description
long_description	String	The offer's long description
short_description	String	The offer's short description
no_awards_status_text	String	The text that should appear to inform the participant that he has not been awarded yet. Deprecated from CRM.COM R17.0.0
times_awarded_status_text	String	The text that should appear to inform the participant that the number displayed is the times he has been awarded. Deprecated from CRM.COM R17.0.0
average_weekly_awarded_amount_text	String	The text that should appear to inform the participant that the amount displayed is the average weekly awarded amount. Deprecated from CRM.COM R17.0.0
offer_image	Reward Offer Image Object	The reward large (standard) offer image
offer_small_image	Reward Offer Image Object	The reward small offer image
offer_background	Reward Offer Background Object	The reward offer background which can be an image or a color Deprecated from CRM.COM R17.0.0
offer_stamp_image	Reward Offer Stamp Image Object	The reward offer stamp image Available from CRM.COM R15.0.0 Deprecated from CRM.COM R17.0.0

Referred Objects Response Data

Reward offer Marketing Information Image Object

Name	Type	Description
file_name	String	The name of the file.
file_content_url	String	The url that can be used to access the actual content of the file.
file_mime_type	String	The mime type of the attached file
file_alt_text	String	The alternative text of the attached file, if the file is an image

Reward scheme Marketing Information Background Object

Name	Type	Description
file_name	String	The name of the file.
file_content_url	String	The url that can be used to access the actual content of the file.
file_mime_type	String	The mime type of the attached file
file_alt_text	String	The alternative text of the attached file, if the file is an image
color	String	The hexadecimal value of the color that will be used as a background

Reward offer Marketing Information Stamp Image Object

Name	Type	Description
file_name	String	The name of the file.
file_content_url	String	The url that can be used to access the actual content of the file.
file_mime_type	String	The mime type of the attached file
file_alt_text	String	The alternative text of the attached file, if the file is an image

log_information object response data

Name	Type	Description
created_date	Date	The date that the retrieved record was created
updated_date	Date	The last date that the retrieved record was updated
created_by_unit	Unit Object	The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0
created_by_business_unit	Unit Object	The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Available from CRM.COM R18.0.0
created_by_user	User Object	The user that created the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled
updated_by_unit	Unit Object	The last unit that updated the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0
updated_by_business_unit	Unit Object	The last unit that updated the retrieved record Available from CRM.COM R18.0.0
updated_by_user	User Object	The last user that updated the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

Referred Objects Response Data

unit object response data

Name	Type	Description
id	String	The ID of the retrieved unit
name	String	The name of the retrieved unit
group_name	String	The name of the group that the retrieved unit belongs to
community_name	String	The name of the community that the retrieved unit belongs to
alternative_code	String	The alternative code of the retrieved unit
description	String	The description of the retrieved unit

business unit object response data

Name	Type	Description
id	String	The ID of the retrieved business unit
name	String	The name of the retrieved business unit
code	String	The code of the retrieved business unit
unified_code	String	The unified code of the retrieved business unit
description	String	The description of the retrieved business unit
parent_business_unit_name	String	The name of the parent business unit that the retrieved business unit belongs to

user object response data

Name	Type	Description
id	String	The ID of the retrieved user
username	String	The user name of the retrieved user
person_name	String	The full name of the retrieved user
email	String	The email of the retrieved user

Examples

Example 1

HTTP Method: POST

Request:

Body:

Response:

Example 2

HTTP Method: POST

Request:

Body:

Response: