---
title: "Brand Rewards Catalog"
method: GET
path: "/rewards/brand/{brandId}"
tags: ["Rewards"]
---

# Brand Rewards Catalog

`GET /rewards/brand/{brandId}`

## Request

- Base URL: `https://opti-ls-api-us.optimove.net/api`
- URL: `https://opti-ls-api-us.optimove.net/api/rewards/brand/{brandId}`
- Auth: none declared

All reward types configured for the brand. Cross-reference `rewardTypeId` from player rewards, mission rewards, and leaderboard prizes against this list to get names and icons.

The catalog changes infrequently. Cache it for the widget session lifetime and re-fetch on the next page load.

## Path parameters

- `brandId` string, uuid, required

## Query parameters

- `type` 'currency' | 'progression' | 'badge' | 'additional'

## Response `200`

Array of reward types.

- Reward[]
  - `id` string, uuid: UUID of this reward type. Matches `rewardTypeId` in player rewards and mission reward items.
  - `name` string: Display name (e.g. "Gold Coin", "VIP Badge").
  - `description` string, nullable: Optional description of the reward.
  - `type` 'currency' | 'progression' | 'badge' | 'additional': `currency` (spendable balance), `progression` (XP/level point), `badge` (collectible), or `additional` (custom reward identified by `shortCode` for downstream fulfillment).
  - `icon` string, nullable: URL to the reward icon.
  - `tag` 'common' | 'rare' | 'epic' | 'legendary': Rarity tier. Use to apply visual styling.
  - `shortCode` string, nullable: Optional short code identifying the reward. Sent in the webhook payload when an `additional`-type reward is claimed, so you can map it to downstream fulfillment systems. `null` for other reward types or when not configured.
  - `tenantId` integer
  - `brandId` string, uuid
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[API](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api.md) - [All operations](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/revisions/f174877a5fb7?raw)