OPoptimove
Leaderboards

List Leaderboards for a Player

Leaderboards and tournaments visible to the player: those not limited to any target group, plus those that share at least one target group with the player. Use this list in any player-facing UI.

Target group membership comes from Optimove and refreshes daily, so a player added to a group may not see its tournaments until the next day.

get/leaderboards/brand/{brandId}/player/{playerId}

Request

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

Path parameters

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

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

playerIdstring required
Example:player-123

Your internal player/customer identifier.

Query parameters

type'leaderboard' | 'tournament'

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

Response

Array of leaderboards visible to the player.

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.