---
title: "List frames for a given game"
method: GET
path: "/dota2/games/{dota2_game_id}/frames"
tags: ["Dota2 games"]
---

# List frames for a given game

`GET /dota2/games/{dota2_game_id}/frames`

List frames for a given Dota 2 game
> ℹ️  
> 
> This endpoint is only available to customers with a real-time data plan

## Path parameters

- `dota2_game_id` integer, required

## Query parameters

- `page` union
  - integer
  - object
    - `number` integer
    - `size` integer
- `per_page` integer

## Response `200`

A list of Dota2 game frames

- object[]
  - `current_timestamp` integer, required — Time elapsed since the beginning of the game, in seconds
  - `dire_team` object, required
    - `gold_advantage` number, required — Gold advantage of the team (negative if deficit)
    - `id` integer, required — The ID of the team.
    - `name` string, required — The name of the team.
    - `players` object[], required — The players of the team
      - `gold` integer, required — Total gold of the player
      - `hero` object, required
        - `id` integer, required
        - `localized_name` string, required
        - `name` string, required
      - `id` integer, required — ID of the player
      - `name` string, required — Professional name of the player
      - `xp` integer, required — Total experience of the player
    - `xp_advantage` number, required — Experience advantage of the team (negative if deficit)
  - `radiant_team` object, required
    - `gold_advantage` number, required — Gold advantage of the team (negative if deficit)
    - `id` integer, required — The ID of the team.
    - `name` string, required — The name of the team.
    - `players` object[], required — The players of the team
      - `gold` integer, required — Total gold of the player
      - `hero` object, required
        - `id` integer, required
        - `localized_name` string, required
        - `name` string, required
      - `id` integer, required — ID of the player
      - `name` string, required — Professional name of the player
      - `xp` integer, required — Total experience of the player
    - `xp_advantage` number, required — Experience advantage of the team (negative if deficit)

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/pandascore/apis/all-videogames.md) · [All operations](https://skmtc.net/pandascore/apis/all-videogames/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandascore/all-videogames/versions/3bf456812994/schema)
