Progress
Player progress tracking and leaderboards
Retrieve leaderboard rankings for a specific game with optional filtering and sorting
Game ID (UUID)
Filter by specific level
Sort field (cannot be 'level')
scorePossible values: Sort direction
DESCPossible values: Number of results to return
10Leaderboard data
Invalid parameters
GET /api/games/{id}/leaderboard HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*
{
"data": [
{
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"name": "Puzzle Master",
"parcel": "10,20",
"user_address": "0x1234567890123456789012345678901234567890",
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
]
}Retrieve the authenticated user's progress history in a specific game
Game ID (UUID)
Sort field
updated_atPossible values: Sort direction
DESCPossible values: Number of results to return
10User progress data
Invalid UUID
GET /api/games/{id}/progress HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*
{
"data": [
{
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"id": "550e8400-e29b-41d4-a716-446655440004",
"game_id": "550e8400-e29b-41d4-a716-446655440000",
"user_address": "0x1234567890123456789012345678901234567890",
"user_name": "Player123",
"data": {
"powerUpsUsed": 3,
"enemiesDefeated": 10
},
"updated_at": "2024-10-30T12:34:56.789Z"
}
]
}Submit new game progress for the authenticated user. Automatically checks for challenge completion and mission completion.
Game ID (UUID)
Game score
1500Current level achieved
5Time taken (seconds/milliseconds)
120.5Number of moves made
45User's display name
Player123Progress submitted successfully
Invalid request payload or UUID
POST /api/games/{id}/progress HTTP/1.1
Host: exploration-games.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"user_name": "Player123",
"data": {
"powerUpsUsed": 3
}
}{
"data": {
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"id": "550e8400-e29b-41d4-a716-446655440004",
"game_id": "550e8400-e29b-41d4-a716-446655440000",
"user_address": "0x1234567890123456789012345678901234567890",
"user_name": "Player123",
"data": {
"powerUpsUsed": 3,
"enemiesDefeated": 10
},
"updated_at": "2024-10-30T12:34:56.789Z"
}
}Retrieve all user progress entries for a specific game with pagination (Admin only)
Game ID (UUID)
Filter by specific level
Sort field
updated_atPossible values: Sort direction
DESCPossible values: Number of results per page
10Page number
1All progress data
Invalid UUID
GET /api/games/{id}/progress/all HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*
{
"data": [
{
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"id": "550e8400-e29b-41d4-a716-446655440004",
"game_id": "550e8400-e29b-41d4-a716-446655440000",
"user_address": "0x1234567890123456789012345678901234567890",
"user_name": "Player123",
"data": {
"powerUpsUsed": 3,
"enemiesDefeated": 10
},
"updated_at": "2024-10-30T12:34:56.789Z"
}
]
}Retrieve all games being played by the authenticated user with their latest progress
List of games played by user
GET /api/games/progress HTTP/1.1
Host: exploration-games.decentraland.org
Accept: */*
List of games played by user
{
"data": [
{
"score": 1500,
"level": 5,
"time": 120.5,
"moves": 45,
"name": "Puzzle Master",
"parcel": "10,20",
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
]
}Enable or disable specific progress entries (Admin only)
Array of progress entry IDs
["550e8400-e29b-41d4-a716-446655440004"]Whether to disable (true) or enable (false) the progress entries
falseProgress status updated
Updated progress entries
Invalid request payload
PATCH /api/games/progress/status HTTP/1.1
Host: exploration-games.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 65
{
"ids": [
"550e8400-e29b-41d4-a716-446655440004"
],
"disabled": false
}{
"data": [
{}
]
}Last updated