Stages

GET /tournaments/{tournament_id}/stages

Simple Access

Returns all stages of a tournament with basic information and settings.

Resource URL

https://api.toornament.com/viewer/v2/tournaments/{tournament_id}/stages

HTTP headers

Path parameters

  • tournament_id
    string

    The id of the tournament for which stages must be retrieved

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Stages retrieved

Example
[
    {
        "id": "618983668512789184",
        "number": 2,
        "name": "Playoffs",
        "type": "double_elimination",
        "closed": false,
        "settings": {
            "size": 16,
            "grand_final": "simple",
            "threshold": 0,
            "skip_round1": false
        }
    }
]
Structure (collection)
  • id
    string

    The id of the stage

    Example: "618983668512789184"

  • number
    integer

    A number used for ordering stages

    Example: 2

  • name
    string

    The name of the stage (maximum 30 characters)

    Example: "Playoffs"

  • type
    string

    The type of stage that defines how the stage functions

    Example: "double_elimination"

  • closed
    boolean

    Whether the stage is closed

    Example: false

  • settings
    object

    Settings that describes various options for the stage type

    Example: {"size":16,"grand_final":"simple","threshold":0,"skip_round1":false}

GET /tournaments/{tournament_id}/stages/{id}

Simple Access

Returns a stage by the given id with basic information and settings.

Resource URL

https://api.toornament.com/viewer/v2/tournaments/{tournament_id}/stages/{id}

HTTP headers

Path parameters

  • tournament_id
    string

    The id of the tournament that contains the stage

  • id
    string

    The id of the stage to retrieve

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Stage retrieved

Example
{
    "id": "618983668512789184",
    "number": 2,
    "name": "Playoffs",
    "type": "double_elimination",
    "closed": false,
    "settings": {
        "size": 16,
        "grand_final": "simple",
        "threshold": 0,
        "skip_round1": false
    }
}
Structure (object)
  • id
    string

    The id of the stage

    Example: "618983668512789184"

  • number
    integer

    A number used for ordering stages

    Example: 2

  • name
    string

    The name of the stage (maximum 30 characters)

    Example: "Playoffs"

  • type
    string

    The type of stage that defines how the stage functions

    Example: "double_elimination"

  • closed
    boolean

    Whether the stage is closed

    Example: false

  • settings
    object

    Settings that describes various options for the stage type

    Example: {"size":16,"grand_final":"simple","threshold":0,"skip_round1":false}