Stages

GET /tournaments/{tournament_id}/stages

Returns a collection of stages from one tournament. The tournament must be public to have access to its stages, meaning the tournament organizer must publish it.

Resource URL

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

Path parameters

  • tournament_id
    string

    Id of the desired tournament.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200]

Example
[
    {
        "number": 1,
        "name": "Playoffs",
        "type": "single_elimination",
        "size": 8
    }
]
Structure (collection)
  • number
    integer

    Stage number.

    Example: 1

  • name
    string

    Name of this stage.

    Example: "Playoffs"

  • type
    string

    Stage type.

    Possible values: group, league, swiss, single_elimination, double_elimination, bracket_group

  • size
    integer

    Number of participants of this stage.

    Example: 8

GET /tournaments/{tournament_id}/stages/{number}

Deprecated

Deprecated

With the release of the Toornament version 2, the tournament engine has been rebuilt from scratch. The current stage API endpoints are no longer working, new version of the endpoints will be released in the coming weeks.

Returns information about one stage. The type of information provided depends on the type of stage. A description is provided in each matching response.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/stages/{number}

Path parameters

  • tournament_id
    string

    Id of the desired tournament.

  • number
    integer

    Stage number of the tournament

Query Parameters

  • with_groups
    boolean

    When set to '1', it will include a summary of each groups of the stage.

    Allowed values: 1, 0

    Default: 0

  • with_rounds
    boolean

    When set to '1', it will include a summary of each rounds of each groups of the stage.

    Allowed values: 1, 0

    Default: 0

Request Body

This endpoint doesn't require a request body.

Responses

GET /tournaments/{tournament_id}/stages/{number}/view

Deprecated

Deprecated

With the release of the Toornament version 2, the tournament engine has been rebuilt from scratch. The current stage API endpoints are no longer working, new version of the endpoints will be released in the coming weeks.

Returns detailed view information about one stage. The type of information provided depends on the type of stage. A description is provided in each matching response.

Resource URL

https://api.toornament.com/v1/tournaments/{tournament_id}/stages/{number}/view

Path parameters

  • tournament_id
    string

    The id of the desired tournament.

  • number
    integer

    The stage number of the tournament

Query Parameters

  • bracket_layout
    string

    Usable with brackets. Type of placement nodes: "balanced" places parent nodes of two children at the same distance of both children; "minimal" reduces the height of the bracket by moving nodes with a single child at the same level.

    Allowed values: balanced, minimal

    Default: balanced

Request Body

This endpoint doesn't require a request body.

Responses