---
title: "Ranking of an activity"
method: GET
path: "/v1/reports/games/{gameId}/ranking/"
tags: ["Reports"]
---

# Ranking of an activity

`GET /v1/reports/games/{gameId}/ranking/`

## Request

- Base URL: `https://api.educaplay.com`
- URL: `https://api.educaplay.com/v1/reports/games/{gameId}/ranking/`
- Auth: HTTP bearer

Paginated ranking of the players who completed one activity, best score first. Pages hold up to 50 items.

## Path parameters

- `gameId` integer, required

## Query parameters

- `filter` 'lastDay' | 'lastWeek' | 'lastYear' | 'custom'
- `tss` string
- `tse` string
- `page` integer

## Response `200`

Report data for the requested period.

- GamesRankingResponse
  - `items` object[]: Ranking rows, best score first.
  - `hasMore` boolean
  - `page` integer

## Other responses

- `401`: Authentication is missing or the Bearer token is invalid.
- `404`: The requested resource does not exist.
- `429`: The request rate limit for the account has been exceeded. Limits depend on the subscription plan (Basic 120, Advanced 300, Academic 600 and Commercial 1200 requests per minute) and are measured over a fixed 60 second window. Wait the number of seconds given in the `Retry-After` header before retrying.

## Changes

- **2026-10-19** `e31d97013d0d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/educaplay/apis/educaplay-api/changes/v1/reports/games/:gameId/ranking/get.md)

---

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