GuidesHelp CenterSign up

The promotion tier object

This entity describes a promotion tier (note: promotion tiers are always assigned to a campaign, can't be used standalone)

AttributeDescriptionExample
id
string		promo_s2Ynoxm3Q91xwF5qVwzpYgMf
object
string		Type of the object represented by JSON. Value is promotion_tier.
name
string		Name of the promotion tier.BFCM 2017
banner
string		Text presented to the customer when applying the promotion.Congratulations, you get $10 off.
campaign
object		Contains common properties of promotion tiers within a campaign they belong to.{ "id": "camp_M7nEJ40solLyPvS8tAx006bX", "start_date": "2017-10-24T00:00:00Z", "expiration_date": "2017-10-27T23:59:59Z", "active": true }
validation_rule_assignments
object		Contains a list of validation rule assignments. Validation Rules can be created and assigned with the use of Validation Rules api. During validation and redemption request are validated against assigned validation rules.{ "object": "list", "total": 1, "data_ref": "data", "data": [ { "id": "asgn_1234", "rule_id": "val_1234", "related_object_id": "promo_1234", "related_object_type": "promotion_tier", "created_at": "2018-12-19T10:25:50Z", "updated_at": null, "object": "validation_rules_assignment" } ] }
action
object		Specifies results of the promotion.{ "discount": { "type": "AMOUNT", "amount_off": 1000 } }
metadataA set of custom key/value pairs.{ "approved": true, "level": 1 }
{
    "id": "promo_s2Ynoxm3Q91xwF5qVwzpYgMf",
    "object": "promotion_tier",
    "name": "BFCM 2017",
    "banner": "Congratulations, you get $10 off.",
    "campaign": {
        "id": "camp_M7nEJ40solLyPvS8tAx006bX",
        "object": "campaign",
        "start_date": "2017-10-24T00:00:00Z",
        "expiration_date": "2017-10-27T23:59:59Z",
        "active": true
    },
    "validation_rule_assignments": {
      "object": "list",
      "total": 1,
      "data_ref": "data",
      "data": [
        {
          "id": "asgm_hXnKYgeW74BsDByc",
          "rule_id": "val_bXOKIS7bAMaG",
          "related_object_id": "promo_s2Ynoxm3Q91xwF5qVwzpYgMf",
          "related_object_type": "promotion_tier",
          "created_at": "2018-12-19T10:25:50Z",
          "updated_at": null,
          "object": "validation_rules_assignment"
        }
      ]
    },
    "action": {
        "discount": {
            "type": "AMOUNT",
            "amount_off": 1000
        }
    },
    "metadata": null
}