---
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`

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