---
title: "POST /v1/admin/leaderboards/{leaderboardId}/award-prizes"
method: POST
path: "/v1/admin/leaderboards/{leaderboardId}/award-prizes"
tags: ["leaderboards"]
---

# POST /v1/admin/leaderboards/{leaderboardId}/award-prizes

`POST /v1/admin/leaderboards/{leaderboardId}/award-prizes`

## Request

- Base URL: `https://api.versusgame.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.versusgame.com/v1/admin/leaderboards/{leaderboardId}/award-prizes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/versusgame/apis/versusgame-api/docs/v1/admin/leaderboards/:leaderboardId/award-prizes/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `leaderboardId` string, required

## Request body

- AwardLeaderboardDto
  - `version` number, required

## Response `200`

Allow an Admin to manually trigger a Leaderboard Prize Award

- LeaderboardAdmin
  - `state` 'OPEN' | 'FULL' | 'AWARDING' | 'ARCHIVED', required
  - `league` 'level1' | 'level2' | 'level3' | 'level4', required
  - `id` string, required
  - `prizeName` string, required
  - `prizeType` string, required
  - `prizeValue` number, required
  - `imageAssetId` string, required
  - `imageAssetUrl` string
  - `startDate` string, required
  - `endDate` string, required
  - `prizeDrawingDate` string, required
  - `pointThreshold` number, required
  - `numberOfPrizes` number, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `distributorId` string, required
  - `version` number, required
  - `isVerified` boolean
  - `prizeNameShort` string
  - `imageSmallAssetId` string
  - `imageSmallAssetUrl` string
  - `imageIconAssetId` string
  - `imageIconAssetUrl` string
  - `prizeTitle` string, required
  - `prizeShortTitle` string, required
  - `maxUsersThreshold` number, required
  - `playerCount` number, required
  - `gameplays` number, required
  - `gameplaysThreshold` number
  - `revenueThreshold` number, required

---

[API](https://skmtc.dev/versusgame/apis/versusgame-api.md) - [All operations](https://skmtc.dev/versusgame/apis/versusgame-api/llms.txt) - [OpenAPI document](https://skmtc.dev/versusgame/apis/versusgame-api/revisions/e86f45ae5f7c?raw)