> ## Documentation Index
> Fetch the complete documentation index at: https://voucherify-pz-test.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Loyalty Tier Object

## Loyalty Tier

All of:

1. [Loyalty Tier Base](#loyalty-tier-base)

2. | Attributes                  | Description                                                                                                                                                                                                                                                                 |
   | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | id`string`                  | Unique loyalty tier ID.                                                                                                                                                                                                                                                     |
   | campaign\_id`string`        | Unique parent campaign ID.                                                                                                                                                                                                                                                  |
   | metadata`object`, `null`    | The metadata object stores all custom attributes assigned to the loyalty tier. A set of key/value pairs that you can attach to a loyalty tier object. It can be useful for storing additional information about the loyalty tier in a structured format.                    |
   | created\_at`string`         | Timestamp representing the date and time when the loyalty tier was created. The value is shown in the ISO 8601 format.                                                                                                                                                      |
   | updated\_at`string`, `null` | Timestamp representing the date and time when the loyalty tier was updated. The value is shown in the ISO 8601 format.                                                                                                                                                      |
   | config`object`              | Defines loyalty tier range in points.Attributes	Descriptionpointsobject&#xA;&#xA;Defines range of loyalty tier in points.&#xA;&#xA;Attributes	Descriptionfrominteger	&#xA;&#xA;Bottom points threshold value.&#xA;&#xA;&#xA;tointeger	&#xA;&#xA;Top points threshold value. |
   | expiration                  | See: [Loyalty Tier Expiration](#loyalty-tier-expiration)                                                                                                                                                                                                                    |
   | object`string`              | The type of the object represented by JSON. This object stores information about the loyalty.Available values: `loyalty_tier`                                                                                                                                               |

## Loyalty Tier Base

| Attributes             | Description                                                                                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name`string`           | Loyalty Tier name.                                                                                                                                                              |
| earning\_rules`object` | Contains a list of earning rule IDs and their points mapping for the given earning rule.Attributes	Description\[propertyName]	See: MappingPoints                                |
| rewards`object`        | Contains a list of reward IDs and their points mapping for the given reward.Attributes	Description\[propertyName]	See: MappingPoints                                            |
| points`object`         | Defines range of loyalty tier in points.Attributes	Descriptionfrominteger&#xA;&#xA;Bottom points threshold value.&#xA;&#xA;&#xA;tointeger	&#xA;&#xA;Top points threshold value. |

## Loyalty Tier Expiration

| Attributes               | Description                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| customer\_id`string`     | Unique customer identifier of the customer making the purchase. The ID is assigned by Voucherify.**Example:**cust\_7iUa6ICKyU6gH40dBU25kQU1                |
| campaign\_id`string`     | Unique campaign ID, assigned by Voucherify.**Example:**camp\_rRsfatlwN7unSeUIJDCYedal                                                                      |
| tier\_id`string`         | Unique tier ID, assigned by Voucherify.                                                                                                                    |
| start\_date`string`      | Activation timestamp defines when the loyalty tier starts to be active in ISO 8601 format. Loyalty tier is inactive before this date.                      |
| expiration\_date`string` | Expiration timestamp defines when the loyalty tier expires in ISO 8601 format. Loyalty tier is inactive after this date.                                   |
| created\_at`string`      | Timestamp representing the date and time when the loyalty tier was created. The value is shown in the ISO 8601 format.**Example:**2021-12-22T10:13:06.487Z |
| updated\_at`string`      | Timestamp representing the date and time when the loyalty tier was updated. The value is shown in the ISO 8601 format.**Example:**2021-12-22T10:13:06.487Z |

## MappingPoints

One of:

[MappingMultiply](#mappingmultiply), [MappingFixed](#mappingfixed)

## MappingMultiply

| Attributes         | Description                                                                    |
| ------------------ | ------------------------------------------------------------------------------ |
| type`string`       | Type of calculation.Available values: `MULTIPLY`                               |
| multiplier`number` | Multiplication factor used to multiply the points to obtain the mapped points. |

## MappingFixed

| Attributes      | Description                                    |
| --------------- | ---------------------------------------------- |
| type`string`    | Type of calculation.Available values: `CUSTOM` |
| points`integer` | Fixed number of points to be applied.          |
