Games (CS:GO)

Counter-Strike: GO

This documentation provides information specifically for the Counter-Strike: GO discipline.

GET /tournaments/{tournament_id}/matches/{match_id}/games

Returns a collection of games from one match. Only match type "duel" or "ffa" supported a game. If the match type is "ffa", games are limited to the first 4 opponents ordered by their position.

On stand by

The CSGO stats feature has been paused with the release of the Toornament version 2.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

Query Parameters

  • with_stats
    boolean

    When set to '1', it will include a summary of stats of the game.

    Allowed values: 1, 0

    Default: 1

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
[
    {
        "number": 1,
        "status": "completed",
        "opponents": [
            {
                "number": 1,
                "position": 1,
                "participant": {
                    "id": "378426939508809728",
                    "name": "Evil Geniuses",
                    "country": "US"
                },
                "result": 1,
                "score": null,
                "forfeit": false,
                "lineup": [
                    {
                        "name": "Bob",
                        "steam_id": "STEAM_0:1:132456",
                        "kills": 14,
                        "deaths": 4,
                        "assists": 2,
                        "kills_per_deaths": 3.5,
                        "headshots": 6,
                        "team_kills": 0,
                        "entry_kills": 4,
                        "damages": 1062,
                        "bomb_planted": 2,
                        "bomb_defused": 0,
                        "clutch3": 1,
                        "clutch4": 0,
                        "clutch5": 0
                    }
                ]
            }
        ],
        "map": "de_dust2"
    }
]
Structure (collection)
  • number
    integer

    Game's number.

    Example: 1

  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

  • stats_provider
    string|null

    Counter-Strike: GOOptional

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • map
    string|null

    Counter-Strike: GO

    The map on which the game is played.

    Example: "de_dust2"

GET /tournaments/{tournament_id}/matches/{match_id}/games/{number}

Returns detailed information about one game. Only match type "duel" or "ffa" supported a game. If the match type is "ffa", a game returns a maximum of 100 opponents.

On stand by

The CSGO stats feature has been paused with the release of the Toornament version 2.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match

Query Parameters

  • with_stats
    boolean

    When set to '1', it will include a summary of stats of the game.

    Allowed values: 1, 0

    Default: 1

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
{
    "number": 1,
    "status": "completed",
    "opponents": [
        {
            "number": 1,
            "position": 1,
            "participant": {
                "id": "378426939508809728",
                "name": "Evil Geniuses",
                "country": "US"
            },
            "result": 1,
            "score": null,
            "forfeit": false,
            "lineup": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ],
    "map": "de_dust2"
}
Structure (object)
  • number
    integer

    Game's number.

    Example: 1

  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

  • stats_provider
    string|null

    Counter-Strike: GOOptional

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • map
    string|null

    Counter-Strike: GO

    The map on which the game is played.

    Example: "de_dust2"

PATCH /tournaments/{tournament_id}/matches/{match_id}/games/{number}

Authorized Access

If you need to make changes on your game data, you are able to do so by patching one or several fields of your game. Only match type "duel" or "ffa" supported a game.

Warning! This endpoint can only be used with an Authorized Access.

On stand by

The CSGO stats feature has been paused with the release of the Toornament version 2.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

Game data

Example
{
    "map": "de_dust2"
}
Structure (object)
  • map
    string|null

    Counter-Strike: GO

    The map on which the game is played.

    Example: "de_dust2"

Response

[200] Success

Example
{
    "number": 1,
    "status": "completed",
    "opponents": [
        {
            "number": 1,
            "position": 1,
            "participant": {
                "id": "378426939508809728",
                "name": "Evil Geniuses",
                "country": "US"
            },
            "result": 1,
            "score": null,
            "forfeit": false,
            "lineup": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ],
    "map": "de_dust2"
}
Structure (object)
  • number
    integer

    Game's number.

    Example: 1

  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

  • stats_provider
    string|null

    Counter-Strike: GOOptional

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • map
    string|null

    Counter-Strike: GO

    The map on which the game is played.

    Example: "de_dust2"

GET /tournaments/{tournament_id}/matches/{match_id}/games/{number}/result

Returns detailed result about one specific game. Only match type "duel" supported the result endpoint.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/result

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
{
    "status": "completed",
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "score": null,
            "forfeit": false
        }
    ]
}
Structure (object)
  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

PUT /tournaments/{tournament_id}/matches/{match_id}/games/{number}/result

Authorized Access

Updates or creates detailed result about one game. Only match type "duel" supported the result endpoint.

Warning! This endpoint can only be used with an Authorized Access.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/result

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

Query Parameters

  • update_match
    boolean

    When set to "1", also updates result match of this game. When set to '0', updates only game result.

    Allowed values: 0, 1

    Default: 1

Request Body

Update or create

Example
{
    "status": "completed",
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "score": null,
            "forfeit": false
        }
    ]
}
Structure (object)
  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

Response

[200] Success

Example
{
    "status": "completed",
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "score": null,
            "forfeit": false
        }
    ]
}
Structure (object)
  • status
    string

    Game's status: "pending" means it hasn’t started yet; "running" means it has started but not ended yet; "completed" indicates the game is finished.

    Possible values: pending, running, completed

  • opponents
    array[object]

GET /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats

Retrieves latest statistics from a given game.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
{
    "provider": null,
    "round": 9,
    "outcome": null,
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "side": "terrorist",
            "players": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ]
}
Structure (object)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

GET /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds

Retrieves statistics from a collection of consecutive rounds in a game.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
[
    {
        "provider": null,
        "round": 9,
        "outcome": null,
        "opponents": [
            {
                "number": 1,
                "result": 1,
                "side": "terrorist",
                "players": [
                    {
                        "name": "Bob",
                        "steam_id": "STEAM_0:1:132456",
                        "kills": 14,
                        "deaths": 4,
                        "assists": 2,
                        "kills_per_deaths": 3.5,
                        "headshots": 6,
                        "team_kills": 0,
                        "entry_kills": 4,
                        "damages": 1062,
                        "bomb_planted": 2,
                        "bomb_defused": 0,
                        "clutch3": 1,
                        "clutch4": 0,
                        "clutch5": 0
                    }
                ]
            }
        ]
    }
]
Structure (collection)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

PUT /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds

Authorized Access

Updates or creates detailed statistics about all rounds from a game.

Warning! This endpoint can only be used with an Authorized Access.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

Update or create all rounds

Example
[
    {
        "provider": null,
        "round": 9,
        "outcome": null,
        "opponents": [
            {
                "number": 1,
                "result": 1,
                "side": "terrorist",
                "players": [
                    {
                        "name": "Bob",
                        "steam_id": "STEAM_0:1:132456",
                        "kills": 14,
                        "deaths": 4,
                        "assists": 2,
                        "kills_per_deaths": 3.5,
                        "headshots": 6,
                        "team_kills": 0,
                        "entry_kills": 4,
                        "damages": 1062,
                        "bomb_planted": 2,
                        "bomb_defused": 0,
                        "clutch3": 1,
                        "clutch4": 0,
                        "clutch5": 0
                    }
                ]
            }
        ]
    }
]
Structure (collection)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

Response

[200] Success

Example
[
    {
        "provider": null,
        "round": 9,
        "outcome": null,
        "opponents": [
            {
                "number": 1,
                "result": 1,
                "side": "terrorist",
                "players": [
                    {
                        "name": "Bob",
                        "steam_id": "STEAM_0:1:132456",
                        "kills": 14,
                        "deaths": 4,
                        "assists": 2,
                        "kills_per_deaths": 3.5,
                        "headshots": 6,
                        "team_kills": 0,
                        "entry_kills": 4,
                        "damages": 1062,
                        "bomb_planted": 2,
                        "bomb_defused": 0,
                        "clutch3": 1,
                        "clutch4": 0,
                        "clutch5": 0
                    }
                ]
            }
        ]
    }
]
Structure (collection)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

GET /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Retrieves statistics from start to a specified round in the game.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

  • round_number
    integer

    The round number of the stats.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
{
    "provider": null,
    "round": 9,
    "outcome": null,
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "side": "terrorist",
            "players": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ]
}
Structure (object)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

PUT /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Authorized Access

Updates or creates detailed statistics about a designated round from a game.

Warning! This endpoint can only be used with an Authorized Access.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

  • round_number
    integer

    The round number of the stats.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

Update or create

Example
{
    "provider": null,
    "round": 9,
    "outcome": null,
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "side": "terrorist",
            "players": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ]
}
Structure (object)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

Response

[200] Success

Example
{
    "provider": null,
    "round": 9,
    "outcome": null,
    "opponents": [
        {
            "number": 1,
            "result": 1,
            "side": "terrorist",
            "players": [
                {
                    "name": "Bob",
                    "steam_id": "STEAM_0:1:132456",
                    "kills": 14,
                    "deaths": 4,
                    "assists": 2,
                    "kills_per_deaths": 3.5,
                    "headshots": 6,
                    "team_kills": 0,
                    "entry_kills": 4,
                    "damages": 1062,
                    "bomb_planted": 2,
                    "bomb_defused": 0,
                    "clutch3": 1,
                    "clutch4": 0,
                    "clutch5": 0
                }
            ]
        }
    ]
}
Structure (object)
  • provider
    string|null

    Source from which this statistic is built upon.

    Possible values: adminbot, ebot

  • round
    integer

    The round number.

    Example: 9

  • outcome
    string|null

    Outcome of the round.

    Possible values: team_eliminated, bomb_defused, target_bombed, target_saved

  • opponents
    array[object]

DELETE /tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Authorized Access

Delete detailed statistics about a designated round from a game.

Warning! This endpoint can only be used with an Authorized Access.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/matches/{match_id}/games/{number}/stats/rounds/{round_number}

Path parameters

  • tournament_id
    string

    The id of the match's tournament.

  • match_id
    string

    The id of the game's match.

  • number
    integer

    The game number of the match.

  • round_number
    integer

    The round number of the stats.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[204] Success