Submit score to a leaderboard

POST

api/v1/user/{userKey}/leaderboards/{leaderboardId}/score

Submits a score entry to the leaderboard. Creates a user record if first entry, updates high score if applicable.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'api/v1/user/{{user-key}}/leaderboards/{{leaderboard_id}}/score' \
--header 'x-api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "score": 30,
  "metadata": null
}'

Response Example

{
    "entryId": "cc2ece8b-54d9-4717-964e-b1fb220887de",
    "score": 30,
    "isNewHighScore": false,
    "previousHighScore": 44,
    "currentRank": 1,
    "totalEntries": 4,
    "submittedAt": "2025-12-23T14:21:52.8271065Z"
}

Modified at 2025-12-23 14:24:01

Get available leaderboards for user

Get user's leaderboard participation history