GET rewards_participants/configuration/reward_schemes/list
This method returns the effective reward schemes that are allowed to be provided to rewards participants. Multiple reward schemes are returned by each call. Note that only effective reward schemes are retrieved.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
group_identifier (optional) | Group Identifier | The identifier of the group that will be providing the reward scheme. The group is filtered against the reward scheme's allowed organisational units. The allowed group identifier fields are the following:
| ||||||||||||
unit_identifier (optional) | Unit Identifier | The identifier of the unit that will be providing the reward scheme. The unit is filtered against the reward scheme's allowed organisational units. The allowed unit identifier fields are the following:
| ||||||||||||
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 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 retrieved reward scheme that can be Effective or Not Effective |
| requires_reference_code | Boolean | If true then a unique reference code is required in order to sign up to that specific reward scheme Available from CRM.COM R12.7.0 |
| self_signup_enabled | Boolean | If true then rewards participants can sign up to this reward scheme by themselves Available from CRM.COM R12.7.0 |
| auto_signup_enabled | Boolean | If true then rewards participants will automatically be participating to this scheme while they sign up Available from CRM.COM R15.0.0 |
| reference_code_generation_method | String | It determines how the reference code will be generated. The following generation methods are supported:
Available from CRM.COM R15.0.0 |
| supported_email_domains | String | It determines the supported email domains that can be used to sign a rewards participant into a specific rewards scheme that requires a reference code (multiple domains can be returned and will be comma separated) Applicable only if the reference code generation method is set to "AUTO_GENERATED" Available from CRM.COM R15.2.0 |
| log_information | Log Information Object | The log information of the retrieved reward scheme |
| marketing_information | Reward Scheme Marketing Information Object | The reward scheme's marketing information Available from CRM.COM R12.7.0 |
Referred Objects Response Data
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
[
{
"life_cycle_state": "EFFECTIVE",
"id": "E339CFB9284E8BB291E63CC42E574E88",
"name": "Marketing Reward Scheme",
"description": "Marketing Reward Scheme for Sales Department, CRM Team 1, Marketing Team"
},
{
"life_cycle_state": "EFFECTIVE",
"id": "D9789AC11CF4792C21C93BB5A7ABE9DD",
"name": "Marketing Reward Scheme for Call Centre Offers",
"description": "Marketing Reward Scheme for Call Centre Offers"
},
{
"life_cycle_state": "EFFECTIVE",
"id": "EA5CCE98F857F3A928E3AA6891323088",
"name": "Sales Scheme",
"description": "Sales Scheme - TC10"
}
]
}