---
title: "List activities with their results"
method: GET
path: "/v1/reports/games/list/"
tags: ["Reports"]
---

# List activities with their results

`GET /v1/reports/games/list/`

## Request

- Base URL: `https://api.educaplay.com`
- URL: `https://api.educaplay.com/v1/reports/games/list/`
- Auth: HTTP bearer

Paginated list of the user's activities with the aggregated results of the period: number of plays, average accuracy, average time and rating. Pages hold up to 50 items.

## Query parameters

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

## Response `200`

Report data for the requested period.

- GamesListResponse
  - `items` GameListItem[]
    - `id` integer
    - `name` string
    - `slug` string
    - `type` string
    - `created` integer: Creation date of the activity. Unix timestamp in seconds.
    - `plays` integer: Number of plays over the period.
    - `accuracy` integer: Average accuracy, from 0 to 100.
    - `avgTime` integer: Average time per play, in seconds.
    - `rating` number: Average rating, from 0 to 5.
    - `ratingCount` integer
  - `hasMore` boolean
  - `page` integer
  - `_links` HalLink[]
    - `rel` string, required
    - `href` string, uri, required

## Other responses

- `401`: Authentication is missing or the Bearer token is invalid.
- `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/list/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)
