---
title: "Get game leaderboard"
method: GET
path: "/api/games/{id}/leaderboard"
tags: ["Progress"]
---

# Get game leaderboard

`GET /api/games/{id}/leaderboard`

Retrieve leaderboard rankings for a specific game with optional filtering and sorting

## Path parameters

- `id` string, uuid, required

## Query parameters

- `level` integer
- `sort` 'score' | 'updated_at' | 'time' | 'moves'
- `direction` 'ASC' | 'DESC'
- `limit` integer

## Response `200`

Leaderboard data

- object
  - `data` object[]
    - `score` number — Game score
    - `level` integer — Current level achieved
    - `time` number — Time taken (seconds/milliseconds)
    - `moves` number — Number of moves made
    - `name` string, required — Game name
    - `parcel` string, required — Decentraland parcel coordinates
    - `user_address` string, required — User's wallet address
    - `data` object — Custom game-specific data

## Other responses

- `400` — Invalid parameters

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)