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

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 INTERACTIVELY.

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

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

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
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
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
offer_valid_from	Date	The date that the reward offer became valid
offer_valid_to	Date	The date that the reward offer expires
award_valid_from	Date	The date that the award will become valid
award_valid_to	Date	The date that the award will expire
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 reward offer 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

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

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

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

Examples

Example 1

HTTP Method: POST

Request:

Body:

Response:

Example 2

HTTP Method: POST

Request:

Body:

Response: