Rounds

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

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/rounds

HTTP headers

• X-Api-Key

  string

  API key of your application (see Authentication)

• Authorization

  string

  Access token with organizer:result scope (see Authorization)

• Range

  string

  A range of requested items using the rounds unit. The size of the range can not exceed 50. (see Pagination)

  Example: rounds=0-49

Path parameters

• tournament_id

  string

  The id of the tournament you want to retrieve data about.

Query Parameters

• stage_ids

  array

  A list of stage ids to filter.

  Example: 618965765764577354,618931468547654563

• stage_numbers

  array

  A list of stage numbers to filter.

  Example: 1,3

• group_ids

  array

  A list of group ids to filter.

  Example: 618965314871946714,618932178746476544

• group_numbers

  array

  A list of group numbers to filter.

  Example: 3,4

Request Body

This endpoint does not require a request body.

Response

[206] Rounds retrieved.

Example

[
    {
        "id": "618983668512789184",
        "stage_id": "618945443132178479",
        "group_id": "618983668512789184",
        "number": 2,
        "name": "1\/8th Finals",
        "closed": false,
        "settings": {
            "size": 4
        }
    }
]

Structure (collection)

• id

  string

  The id of the round.

  Example: "618983668512789184"

• stage_id

  string

  The id of the stage that contains the round.

  Example: "618945443132178479"

• group_id

  string

  The id of the group that contains the round.

  Example: "618983668512789184"

• number

  integer

  A number used for ordering rounds.

  Example: 2

• name

  string

  The name of the round.

  Max. length: 30 characters

  Example: "1/8th Finals"

• closed

  boolean

  Whether the round is closed.

  Example: false

• settings

  object

  Settings that describe the various options related to the round and stage types.

  Example: {"size":4}

Returns a round with the given id with basic information and settings.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{tournament_id}/rounds/{id}

HTTP headers

• X-Api-Key

  string

  API key of your application (see Authentication)

• Authorization

  string

  Access token with organizer:result scope (see Authorization)

Path parameters

• tournament_id

  string

  The id of the tournament you want to retrieve data about.

• id

  string

  The id of the round to retrieve.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Round retrieved.

Example

{
    "id": "618983668512789184",
    "stage_id": "618945443132178479",
    "group_id": "618983668512789184",
    "number": 2,
    "name": "1\/8th Finals",
    "closed": false,
    "settings": {
        "size": 4
    }
}

Structure (object)

• id

  string

  The id of the round.

  Example: "618983668512789184"

• stage_id

  string

  The id of the stage that contains the round.

  Example: "618945443132178479"

• group_id

  string

  The id of the group that contains the round.

  Example: "618983668512789184"

• number

  integer

  A number used for ordering rounds.

  Example: 2

• name

  string

  The name of the round.

  Max. length: 30 characters

  Example: "1/8th Finals"

• closed

  boolean

  Whether the round is closed.

  Example: false

• settings

  object

  Settings that describe the various options related to the round and stage types.

  Example: {"size":4}