List tiers | Brevo API Documentation

import { BrevoClient } from "@getbrevo/brevo";
async function main() {
    const client = new BrevoClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.tier.getLoyaltyProgramTier("pid", {});
}
main();

{
  "items": [
    {
      "accessConditions": [
        {
          "balanceDefinitionId": "string",
          "createdAt": "2024-01-15T09:30:00Z",
          "minimumValue": 1,
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      ],
      "createdAt": "2024-01-15T09:30:00Z",
      "groupId": "string",
      "imageRef": "string",
      "loyaltyProgramId": "string",
      "name": "string",
      "tierId": "string",
      "tierRewards": [
        {
          "createdAt": "2024-01-15T09:30:00Z",
          "rewardId": "string",
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      ],
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ]
}

Returns the list of tiers defined within the loyalty program.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Path parameters

pidstringRequiredformat: "uuid"

Loyalty Program ID

Query parameters

versionenumOptionalDefaults to draft

Select 'active' to retrieve list of all tiers which are live for clients. Select draft to retrieve list of all non deleted tiers.

Allowed values:

Response

Tier list successfully retrieved

itemslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

1	import { BrevoClient } from "@getbrevo/brevo";
2
3	async function main() {
4	const client = new BrevoClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.tier.getLoyaltyProgramTier("pid", {});
8	}
9	main();

1	{
2	"items": [
3	{
4	"accessConditions": [
5	{
6	"balanceDefinitionId": "string",
7	"createdAt": "2024-01-15T09:30:00Z",
8	"minimumValue": 1,
9	"updatedAt": "2024-01-15T09:30:00Z"
10	}
11	],
12	"createdAt": "2024-01-15T09:30:00Z",
13	"groupId": "string",
14	"imageRef": "string",
15	"loyaltyProgramId": "string",
16	"name": "string",
17	"tierId": "string",
18	"tierRewards": [
19	{
20	"createdAt": "2024-01-15T09:30:00Z",
21	"rewardId": "string",
22	"updatedAt": "2024-01-15T09:30:00Z"
23	}
24	],
25	"updatedAt": "2024-01-15T09:30:00Z"
26	}
27	]
28	}