POST reward_offers/list
This method returns information related with reward offers. Multiple reward offers are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||||||||||||||||||||
token | String | The token retrieved from the login method | ||||||||||||||||||||||||||||||
classification_identifier | Classification Identifier | The identifier of the classifications that the reward offers retrieved should be classified as. The allowed fields are the following:
| ||||||||||||||||||||||||||||||
group_identifier (optional) | Group Identifier | The identifier of the group owns reward offer. The allowed unit identifier fields are the following:
| ||||||||||||||||||||||||||||||
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:
| ||||||||||||||||||||||||||||||
category_identifier | Reward offer category identifier | The identifier of the reward offer category related with the reward offer that should be returned as a result. The allowed reward offer category identifier fields are the following:
Deprecated from CRM.COM R15.0.0 | ||||||||||||||||||||||||||||||
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:
| ||||||||||||||||||||||||||||||
rewards_participant_identifier (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:
Deprecated from CRM.COM R17.0.0 | ||||||||||||||||||||||||||||||
accounts_receivable_identifier (optional) | Accounts Receivable identifier | The identifier of the rewards participant's accounts receivable. The allowed accounts receivable identifier fields are the following:
| ||||||||||||||||||||||||||||||
wallet_identifier (optional) | Wallet identifier | The identifier of the reward participant's wallet. The allowed wallet identifier fields are the following:
| ||||||||||||||||||||||||||||||
number_of_results (optional) | Number | The number of results that can be retrieved through each call | ||||||||||||||||||||||||||||||
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 | ||||||||||||||||||||||||||||||
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 |
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:
|
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