---
title: "Player Enrollment and Score on a Leaderboard"
method: GET
path: "/leaderboards/{brandId}/{leaderboardId}/player/{playerId}"
tags: ["Leaderboards"]
---

# Player Enrollment and Score on a Leaderboard

`GET /leaderboards/{brandId}/{leaderboardId}/player/{playerId}`

Returns the player's enrollment status and current score on a specific leaderboard. For regular leaderboards `isEnrolled` is always `true` once the leaderboard is active.

## Path parameters

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

## Response `200`

Enrollment record with score.

- PlayerLeaderboardEnrollment
  - `leaderboardId` string
  - `playerId` string
  - `totalAmount` integer — Player's current score on this leaderboard.
  - `isEnrolled` boolean — Whether the player is participating. For regular leaderboards this is always `true` once active.
  - `enrolledAt` string, date-time, nullable — When the player joined. `null` if not enrolled.
  - `costCurrencyId` string, uuid, nullable — UUID of the currency spent to enter (tournaments only). `null` if free.
  - `costAmount` integer, nullable — Amount of currency spent to enter (tournaments only). `null` if free.

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