​
Submit Score

The Submit Score endpoint allows you to submit a player’s score to a specific leaderboard.

​
Endpoint

POST https://cratebytes.com/api/game/leaderboards/[leaderboard id]/submit
​
score (body)
string
required

The score to submit to the leaderboard. must be passed in the request body.

​
authorization (header)
string
required

Bearer [token]

​
Example Response

{
    "statusCode": 200,
    "data": { "message": "Score submitted" }
}

​
Get leaderboard data

The Get Leaderboard Data endpoint allows you to retrieve the data for a specific leaderboard, including player scores and pagination information.

​
Endpoint

GET https://cratebytes.com/api/game/leaderboards/[leaderboard id]?page=[page number]

​
Example Response

statusCode: 200,
data: {
    "leaderboard": {
        "id": "cm2s3akc200000cme6xt95b6m",
        "name": "Leaderboard Name",
        "description": "Leaderboard Description"
    },
    "entries": [
        {
            "player": {
                "guest": true,
                "playerId": "cm2s3aokq00010cmecg6bfbmi",
                "entryData": null
            },
            "score": 990
        },
        {
            "player": {
                "guest": true,
                "playerId": "cm2s3auy400020cme2e21as3h",
                "entryData": "custom data"
            },
            "score": 988
        },
        ...
    ],
    "totalEntries": 480,
    "pages": 48
}