---
title: "Player Badges"
method: GET
path: "/player-rewards/brand/{brandId}/player/{playerId}/badges"
tags: ["Player Rewards"]
---

# Player Badges

`GET /player-rewards/brand/{brandId}/player/{playerId}/badges`

## Request

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

Returns the badges (rewards with `type = "badge"`) earned by the player.

## Path parameters

- `brandId` string, uuid, required
- `playerId` string, required

## Response `200`

Array of badges earned by the player.

- Badge[]
  - `id` string, uuid: UUID of the badge (matches reward catalog `id`).
  - `name` string: Badge display name.
  - `description` string, nullable: What the player did to earn this badge.
  - `type` 'badge': Always `badge` for this endpoint.
  - `icon` string, nullable: URL to the badge image.
  - `tag` 'common' | 'rare' | 'epic' | 'legendary': Rarity tier. Use to apply visual treatment.
  - `shortCode` string, nullable: Present on the underlying reward record. Typically `null` for badges; populated only for `additional`-type rewards.
  - `tenantId` integer
  - `brandId` string, uuid

## Other responses

- `404`: Resource not found (brand, player, mission, leaderboard, etc.).

---

[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)