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

# Brand Rewards Catalog

`GET /rewards/brand/{brandId}`

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

## 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.net/optimove/apis/optimove-api.md) · [All operations](https://skmtc.net/optimove/apis/optimove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimove/optimove-api/revisions/fc55c5b1bec5/schema)