Page Comparison

...

Tip
Available from CRM.COM R14.3.0 Notice that this API maps to POST reward_offers/get_applicable For previous releases check the GET POST reward_offers/show list (legacy) Web Web API

Excerpt
This method returns information related with reward offers. Multiple reward offers are returned by each call

Resource URL

Parameters

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:

number_of_results

BATCH_PROCESS or INTERACTIVELY.

Name

Type

Description

token

String

The token retrieved from the login method

groupclassification_identifier

(optional)

Group Classification Identifier

The identifier of the group owns reward offer. The allowed unit identifier classifications that the reward offers retrieved should be classified as. The allowed fields are the following:

Include Page

V4:group_identifier

reward_scheme_identifier

(optional)

Reward scheme identifier

Include Page

V4:reward_scheme_identifier

category_identifier
(optional)

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

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

group_identifier

(optional)

Group Identifier

The identifier of the group owns reward offer. The allowed unit identifier fields are the following:

Include Page

	V4:rewardgroup_offer_category_identifier
	V4:group_identifier

reward_

offer

scheme_

category_

identifier

Note
Deprecated from CRM.COM R15.0.0

evaluation_method

(optional)

Reward offer evaluation method

(optional)

Reward scheme identifier

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

Include Page

	V4:reward_scheme_identifier
	V4:reward_scheme_identifier

category_identifier
(optional)

Reward Offer spend methodoffer category identifier

The identifier of the reward offer

spend method

category related with the reward offer that should be returned as a result. The allowed reward offer

spend method

category identifier fields are the following:

SPEND_ON_REQUEST, SPEND_INSTANTLY or SPEND_INSTANTLY_THROUGH_VOUCHER

award_currency

(optional)

Currency Identifier

Include Page

	V4:reward_offer_category_identifier
	V4:reward_offer_category_identifier

Note
Deprecated from CRM.COM R15.0.0

evaluation_method

(optional)

Reward offer evaluation method identifier

The identifier of the currency in which reward offer evaluation method related with the reward offer will award rewards participantsthat should be returned as a result. The allowed currency reward offer evaluation method identifier fields are the following:

Include Page

V4:currency_identifier

spend_method

(optional)

NumberReward Offer spend method

The number of results that can be retrieved through each call

offset

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)

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

...

Examples

...

title	Example 1

HTTP Method: POST

Request:

Code Block
{{server}}/crmapi/rest/v2/reward_offers/list

Body

Code Block
{ "token":"{{token}}", "rewards_participant_identifier":{"number":"33"}, "reward_scheme_identifier":{"name":"Main Rewards Scheme"}, "number_of_results":3 }

Response

...

language	js

...

Currency Identifier

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

Include Page

	V4:currency_identifier
	V4:currency_identifier

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:

Include Page

	V4:rewards_participants_identifier_post
	V4:rewards_participants_identifier_post

Tip
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:

Include Page

	V4:accounts_receivable_identifier_post
	V4:accounts_receivable_identifier_post

wallet_identifier

(optional)

Wallet identifier

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

Include Page

	V4:wallet_identifier
	V4:wallet_identifier

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

Include Page

	V4:reward_offer_complete
	V4:reward_offer_complete

Examples

Expand

title	Example 1

HTTP Method: POST

Request:

Code Block
{{server}}/crmapi/rest/v2/reward_offers/list

Body

Code Block
{ "token":"{{token}}", "rewards_participant_identifier":{"number":"33"}, "reward_scheme_identifier":{"name":"Main Rewards Scheme"}, "number_of_results":3 }

Response

Code Block

language	js

{
    "data": [
        {
            "award_valid_from": "2019-04-15T13:25:59",
            "alternative_code": "1OAP",
            "log_information": {
                "created_by_unit": {
                    "alternative_code": "MU",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "Main Unit",
                    "description": "Main Unit",
                    "id": "1"
                },
                "updated_by_unit": {
                    "alternative_code": "MU",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "Main Unit",
                    "description": "Main Unit",
                    "id": "1"
                },
                "created_date": "2018-02-09T14:07:20",
                "updated_date": "2019-04-15T13:23:01",
                "updated_by_user": {
                    "person_name": "Administrator Company",
                    "id": "1",
                    "email": "crm@crm.com",
                    "username": "mpadministrator"
                },
                "created_by_user": {
                    "person_name": "Eleni Michailidou",
                    "id": "086438FAB99B4704A3B6B971C7695222",
                    "email": "e_michailidou@crm.com",
                    "username": "emichailidou"
                }
            },
            "latest_evaluation_date": null,
            "offer_valid_to": null,
            "reward_scheme": {
                "alternative_code": "MRS",
                "name": "Main Rewards Scheme",
                "description": null,
                "id": "827918B0190B466FA578B14C080F02B8",
                "life_cycle_state": "EFFECTIVE"
            },
            "owned_by_group": {
                "alternative_code": "MG",
                "community_name": "Main Community",
                "name": "Main Group",
                "description": "Main Group",
                "id": "1"
            },
            "custom_field_set": [],
            "description": null,
            "spend_method": "SPEND_ON_REQUEST",
            "award_currency": {
                "suffix_symbol": null,
                "prefix_symbol": "€",
                "decimal_part_name": null,
                "code": "EUR",
                "integer_part_name": null,
                "id": "BC91",
                "life_cycle_state": "EFFECTIVE"
            },
            "offer_valid_from": "2018-02-09T14:08:57",
            "life_cycle_state": "EFFECTIVE",
            "classification": "UTILISE_FREE_CAPACITY",
            "evaluation_method": "BATCH_PROCESS_AND_INTERACTIVELY",
            "latest_effective_date": "2018-02-09T14:08:57",
            "number": "2",
            "award_valid_to": "2019-04-20T13:25:59",
            "name": "10% off any purchase",
            "apply_on_top_of_other_applicable_offers": false,
            "id": "6A24D2B5E44F44B28451FE021FCAD51E",
            "award_scope": "APPLY_AWARD_PER_TRANSACTION",
            "category": null,
            "marketing_information": {
                "terms_and_conditions": null,
                "short_description": null,
                "times_awarded_status_text": null,
                "offer_stamp_image": {
                    "file_name": "6A24D2B5E44F44B28451FE021FCAD51E_offer_stamp_image_Capture1.JPG",
                    "file_alt_text": "angelosTest",
                    "file_content_url": "/crm/ImageDownloadServlet?id=6A24D2B5E44F44B28451FE021FCAD51E&groupname=offer_stamp_image",
                    "file_mime_type": "image/jpeg"
                },
                "average_weekly_awarded_amount_text": null,
                "long_description": null,
                "no_awards_status_text": null,
                "offer_image": {
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_background": {
                    "color": null,
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_small_image": {
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                }
            }
        },
        {
            "award_valid_from": "2019-04-15T13:25:59",
            "alternative_code": "1OAP1SU",
            "log_information": {
                "created_by_unit": {
                    "alternative_code": "MU",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "Main Unit",
                    "description": "Main Unit",
                    "id": "1"
                },
                "updated_by_unit": {
                    "alternative_code": "MU",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "Main Unit",
                    "description": "Main Unit",
                    "id": "1"
                },
                "created_date": "2018-0211-09T1428T10:0706:2003",
                "updated_date": "2019-04-15T1315T11:2300:0103",
                "updated_by_user": {
                    "person_name": "AdministratorSTAGING DATABASE CompanySYS",
                    "id": "1D151F282F81044939F0515C3E16C2FF1",
                    "email": "crm@crm.com"null,
                    "username": "mpadministratorStaging Database"
                },
                "created_by_user": {
                    "person_name": "EleniJosh MichailidouIon",
                    "id": "086438FAB99B4704A3B6B971C76952229094CC8E20C44560A17C33C4EBFCA8CA",
                    "email": "e_michailidou@crm.com"null,
                    "username": "emichailidoujioannou"
                }
            },
            "latest_evaluation_date": null"2019-04-15 11:00:00.0",
            "offer_valid_to": null,
            "reward_scheme": {
                "alternative_code": "MRS",
                "name": "Main Rewards Scheme",
                "description": null,
                "id": "827918B0190B466FA578B14C080F02B8",
                "life_cycle_state": "EFFECTIVE": "EFFECTIVE"
            },
            "owned_by_group": null,
             }"custom_field_set": [],
            "owned_by_groupdescription": {
   null,
            "alternativespend_codemethod": "MGSPEND_ON_REQUEST",
                "communityaward_namecurrency": "Main Community",{
                "namesuffix_symbol": "Main Group"null,
                "descriptionprefix_symbol": "Main Group€",
                "iddecimal_part_name": "1"null,
            },             "custom_field_set": [],"code": "EUR",
                "descriptioninteger_part_name": null,
            "spend_method    "id": "SPEND_ON_REQUESTBC91",
                "awardlife_cycle_currencystate": {"EFFECTIVE"
                "suffix_symbol": null,
},
               "prefix_symbol"offer_valid_from": "€2018-11-28T10:06:08",
                "decimallife_partcycle_namestate": null"EFFECTIVE",
                "codeclassification": "EURREWARD_SIGN_UPS",
                "integerevaluation_part_namemethod": null,
   "BATCH_PROCESS",
            "idlatest_effective_date": "BC912018-11-28T10:06:08",
   
            "life_cycle_statenumber": "EFFECTIVEROS11",
            }"award_valid_to": null,
            "offer_valid_fromname": "2018-02-09T14:08:571st signup",
            "life_cycle_stateapply_on_top_of_other_applicable_offers": "EFFECTIVE"false,
            "classificationid": "UTILISE_FREE_CAPACITYC2E3F7DC4FD341818353797C7A862D2E",
            "evaluation_method": "BATCH_PROCESS_AND_INTERACTIVELY"award_scope": null,
            "latest_effective_datecategory": "2018-02-09T14:08:57"null,
            "numbermarketing_information": "2", {
                "awardterms_validand_toconditions": "2019-04-20T13:25:59"null,
            "name    "short_description": null,
"10% off any purchase",             "applytimes_onawarded_top_of_other_applicable_offersstatus_text": falsenull,
            "id": "6A24D2B5E44F44B28451FE021FCAD51E",    "offer_stamp_image": {
                    "awardfile_scopename": "APPLY_AWARD_PER_TRANSACTION"null,
            "category        "file_alt_text": null,
                 "marketing_information   "file_content_url": {null,
                    "termsfile_andmime_conditionstype": null,
                "short_description": null},
                "timesaverage_weekly_awarded_statusamount_text": null,
                "offerlong_stamp_imagedescription": {null,
                    "file_name": "6A24D2B5E44F44B28451FE021FCAD51E_offer_stamp_image_Capture1.JPG",
   no_awards_status_text": null,
                "fileoffer_alt_textimage": "angelosTest",{
                    "file_content_urlname": "/crm/ImageDownloadServlet?id=6A24D2B5E44F44B28451FE021FCAD51E&groupname=offer_stamp_image"null,
                    "file_mimealt_typetext": "image/jpeg"null,
                     }"file_content_url": null,
                    "averagefile_weekly_awarded_amount_textmime_type": null,
                "long_description": null},
                "no_awards_status_textoffer_background": null,{
                    "offer_imagecolor": {"#de2525",
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_small_backgroundimage": {
                    "colorfile_name": null,
                    "file_alt_nametext": null,
                    "file_altcontent_texturl": null,
                    "file_contentmime_urltype": null,
                }
   "file_mime_type": null        }
        },
        {
       "offer_small_image     "award_valid_from": "2019-04-15T13:25:59",
            "alternative_code": "MCO",
            "log_information": {
 
                  "filecreated_by_nameunit": null,{
                    "filealternative_alt_textcode": null"MU",
                    "filegroup_content_urlname": null"Main Group",
                    "filecommunity_mime_typename": null"Main Community",
               }     "name": "Main Unit",
     }         },      "description": "Main Unit",
{             "award_valid_from": "2019-04-15T13:25:59",
            "alternative_codeid": "1SU1",
               "log_information": { },
                "createdupdated_by_unit": {
                    "alternative_code": "MU",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "Main Unit",
                    "description": "Main Unit",
                    "id": "1"
                },
                "updated_by_unit": {created_date": "2018-12-11T12:49:39",
                "updated_date": "2018-12-11T12:50:29",
     "alternative_code           "updated_by_user": "MU",{
                    "groupperson_name": "MainAdministrator GroupCompany",
                    "community_nameid": "Main Community1",
                    "nameemail": "Main Unitcrm@crm.com",
                    "descriptionusername": "Main Unitmpadministrator",
                },
   "id": "1"            "created_by_user": {
   },                 "createdperson_datename": "2018-11-28T10:06:03",Administrator Company",
                    "updated_dateid": "2019-04-15T11:00:031",
                  "updated_by_user  "email": {"crm@crm.com",
                    "person_nameusername": "STAGING DATABASE SYS",mpadministrator"
                }
           "id": "D151F282F81044939F0515C3E16C2FF1", },
            "latest_evaluation_date": null,
             "emailoffer_valid_to": null,
                    "username"reward_scheme": "Staging{
Database"                 }"alternative_code": "MRS",
                "created_by_username": {"Main Rewards   Scheme",
                "person_namedescription": "Josh Ion",
 null,
                  "id": "9094CC8E20C44560A17C33C4EBFCA8CA827918B0190B466FA578B14C080F02B8",
                    "email"life_cycle_state": null,"EFFECTIVE"
            },
       "username": "jioannou"              "owned_by_group": null,
  }             }"custom_field_set": [],
            "latest_evaluation_datedescription": "2019-04-15 11:00:00.0"null,
            "offerspend_valid_tomethod": null"SPEND_ON_REQUEST",
            "rewardaward_schemecurrency": {
                "alternativesuffix_codesymbol": "MRS"null,
                "nameprefix_symbol": "Main Rewards Scheme€",
                "descriptiondecimal_part_name": null,
                "idcode": "827918B0190B466FA578B14C080F02B8EUR",
                "lifeinteger_cyclepart_statename": "EFFECTIVE"null,
            },             "owned_by_groupid": null"BC91",
                "customlife_fieldcycle_setstate": [],"EFFECTIVE"
            "description": null},
            "spendoffer_valid_methodfrom": "SPEND_ON_REQUEST2018-12-11T12:50:29",
            "awardlife_cycle_currencystate": {"EFFECTIVE",
                "suffix_symbol": null"classification": "UTILISE_FREE_CAPACITY",
                "prefixevaluation_symbolmethod": "€BATCH_PROCESS_AND_INTERACTIVELY",
                "decimallatest_parteffective_namedate": null"2018-12-11T12:50:29",
                "codenumber": "EURROS13",
                "integeraward_partvalid_nameto": null,
   
            "idname": "BC91Merchant C Offer",
 
              "life_cycle_state": "EFFECTIVE"
            }"apply_on_top_of_other_applicable_offers": true,
            "offer_valid_fromid": "2018-11-28T10:06:089DE2B75848774F1993789FF332CF7683",
            "lifeaward_cycle_statescope": "EFFECTIVEAPPLY_AWARD_PER_TRANSACTION",
            "classificationcategory": "REWARD_SIGN_UPS"null,
            "evaluationmarketing_methodinformation": "BATCH_PROCESS", {
                "latestterms_effectiveand_dateconditions": "2018-11-28T10:06:08"null,
            "number    "short_description": "ROS11"null,
             "award_valid_to   "times_awarded_status_text": null,
            "name": "1st signup",  "offer_stamp_image": {
         "apply_on_top_of_other_applicable_offers": false,             "idfile_name": "C2E3F7DC4FD341818353797C7A862D2E"null,
              "award_scope      "file_alt_text": null,
                    "categoryfile_content_url": null,
             "marketing_information       "file_mime_type": {null
                "terms_and_conditions": null},
                "short_descriptionaverage_weekly_awarded_amount_text": null,
                "times_awarded_status_textlong_description": null,
                "offerno_awards_stampstatus_imagetext": {
   null,
                "fileoffer_nameimage": null,{
                    "file_alt_textname": null,
                    "file_contentalt_urltext": null,
                    "file_mimecontent_typeurl": null,
                },                 "average_weekly_awarded_amount_text"file_mime_type": null,
                "long_description": null},
                "no_awards_status_textoffer_background": null,{
                    "offer_imagecolor": {null,
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_backgroundsmall_image": {
                    "color": "#de2525",
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
     null
          },      }
          "offer_small_image": { }
        }
    ],
     "file_namestatus": null,{
           "code": "OK",
        "file_alt_textdescription": null"",
        "message": ""
    }
     "file_content_url": null,
                    "file_mime_type": null
                }
     }

Expand

title	Example 2

HTTP Method: POST

Request:

Code Block
{{server}}/crmapi/rest/v2/reward_offers/list

Body

Code Block
{ "token":"{{token}}", "reward_scheme_identifier":{"name":"Global Scheme"}, "number_of_results":5 }

Response

Code Block

language	js

{
    "data": [
      }         },
        {
            "award_valid_from": "2019-04-15T13:2532:5908",
            "alternative_code": "MCO1OAP_1",
            "log_information": {
                "created_by_unit": {
                    "alternative_code": "MUadminunit",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "MainAdmin Unit",
                    "description": "MainAdmin Unit Description",
                    "id": "1B4529D5D06E749B0976A3512EC4AEDE6"
                },
                "updated_by_unit": {
                    "alternative_code": "MUadminunit",
                    "group_name": "Main Group",
                    "community_name": "Main Community",
                    "name": "MainAdmin Unit",
                    "description": "MainAdmin Unit Description",
                    "id": "1B4529D5D06E749B0976A3512EC4AEDE6"
                },
                "created_date": "20182019-1201-11T1214T13:4945:3929",
                "updated_date": "20182019-1201-11T1229T16:5001:2914",
                "updated_by_user": {
                    "person_name": "Administratorjoseph Companyioannou",
                    "id": "1816C8875D4C34F8890B7CDD5B8322DBC",
                    "email": "crm@crmj_ioannou@crm.com",
                    "username": "mpadministratorj_ioannou"
                },
                "created_by_user": {
                    "person_name": "Administratorjoseph Companyioannou",
                    "id": "1816C8875D4C34F8890B7CDD5B8322DBC",
                    "email": "crm@crmj_ioannou@crm.com",
                    "username": "mpadministratorj_ioannou"
                }
            },
            "latest_evaluation_date": null,
            "offer_valid_to": null,
            "reward_scheme": {
                "alternative_code": "MRSGS",
                "name": "MainGlobal Rewards Scheme",
                "description": null,
                "id": "827918B0190B466FA578B14C080F02B8EDD7AB96067D44BFB10A2280D1CEA3F3",
                "life_cycle_state": "EFFECTIVE"
            },
            "owned_by_group": null,
            "custom_field_set": [],
            "description": null,
            "spend_method": "SPEND_ON_REQUEST",
            "award_currency": {
                "suffix_symbol": null,
                "prefix_symbol": "€",
                "decimal_part_name": null,
                "code": "EUR",
                "integer_part_name": null,
                "id": "BC91",
                "life_cycle_state": "EFFECTIVE"
            },
            "offer_valid_from": "20182019-1201-11T1229T16:5001:2914",
            "life_cycle_state": "EFFECTIVE",
            "classification": "UTILISE_FREE_CAPACITY",
            "evaluation_method": "BATCH_PROCESS_AND_INTERACTIVELY",
            "latest_effective_date": "20182019-1201-11T1229T16:5001:2914",
            "number": "ROS13ROS20",
            "award_valid_to": null,
            "name": "Merchant1% on Call Offerprod",
            "apply_on_top_of_other_applicable_offers": true,
            "id": "9DE2B75848774F1993789FF332CF768342D92B2B58D24DF3A4667623BF6A75E4",
            "award_scope": "APPLY_AWARD_PER_TRANSACTION",
            "category": null,
            "marketing_information": {
                "terms_and_conditions": null,
                "short_description": null,
                "times_awarded_status_text": null,
                "offer_stamp_image": {
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "average_weekly_awarded_amount_text": null,
                "long_description": null,
                "no_awards_status_text": null,
                "offer_image": {
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_background": {
                    "color": null,
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                },
                "offer_small_image": {
                    "file_name": null,
                    "file_alt_text": null,
                    "file_content_url": null,
                    "file_mime_type": null
                }
            }
        }
    ],
    "status": {
        "code": "OK",
        "description": "",
        "message": ""
    }
}

...

Versions Compared

Old Version 22

New Version Current

Key

Resource URL

Parameters

Response Data

Examples

Response Data

Examples