OPoptimove
Leaderboards

List Leaderboards for a Brand

All leaderboards and tournaments configured for the brand, including prize tiers, period dates, and reset cadence.

For repeatable leaderboards, when a period ends the current instance moves to rewarding, then archived, and a new active instance appears in the list automatically.

This list is the same for every player and includes tournaments limited to target groups the player is not in. For player-facing UI use listPlayerLeaderboards.

get/leaderboards/brand/{brandId}

Request

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

Path parameters

brandIdstring uuid required
Example:aebb6a6a-bdef-480f-8096-e13f9c3d4969

Brand UUID returned by GET /brands/default/{tenantId}.

Query parameters

type'leaderboard' | 'tournament'

Optional filter. Return only regular leaderboards, or only tournaments.

Response

Array of leaderboards.

idstring

UUID. Use as leaderboardId in statistics and enrollment calls.

brandIdstring uuid
namestring

Display name shown in the widget.

descriptionstring nullable

Optional longer description.

type'leaderboard' | 'tournament'

leaderboard (auto-enrolled, rank by score) or tournament (opt-in, may have entry cost).

status'draft' | 'active' | 'rewarding' | 'archived'

draft not visible; active running; rewarding period ended, prizes distributing (typically resolves within 5 to 20 minutes); archived terminal state.

objectivesActivatedboolean

true when the leaderboard score is driven by in-app objectives.

startDatestring date-time

When the current period started.

endDatestring date-time

When the current period ends.

isRepeatableboolean

Whether the leaderboard resets and restarts automatically.

resetEveryHoursinteger nullable

Reset interval in hours (e.g. 168 = weekly). null if not repeatable.

objectivesstring[]

Objective IDs that drive the leaderboard score. Empty array when objectivesActivated is false.

participationCostCurrencyIdstring uuid nullable

UUID of the currency required to enter (tournaments only). null if free.

participationCostAmountinteger nullable

Amount of that currency required to enter (tournaments only). null if free.

targetGroupIdsinteger[] nullable

Target groups the leaderboard is limited to. null or empty means open to all players. Already applied in listPlayerLeaderboards.

createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.