Structure API › Rounds

Download OpenAPI 3.0

Endpoints

GET /rounds

Returns all rounds with basic information and settings.

Resource URL

https://api.toornament.com/organizer/v2/rounds

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:result or organizer:admin 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

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

  • tournament_ids
    array

    Only return rounds for the given list of tournaments.

    Example: 618965416546776434,618975467354349191

Request Body

This endpoint does not require a request body.

Response

[206] Rounds retrieved.

Example
[
    {
        "id": "618983668512789184",
        "stage_id": "618945443132178479",
        "group_id": "618983668512789184",
        "tournament_id": "378426939508809728",
        "number": 2,
        "name": "1\/8th Finals",
        "closed": false,
        "settings": {
            "pairing_values": []
        },
        "match_settings": {
            "format": {
                "type": "best_of",
                "options": {
                    "nb_match_sets": 3
                }
            }
        }
    }
]
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"

  • tournament_id
    string

    The id of the tournament that contains this round.

    Example: "378426939508809728"

  • 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: {"pairing_values":[]}

  • match_settings
    object

    Settings that define the match configuration used in the round.

    Example: {"format":{"type":"best_of","options":{"nb_match_sets":3}}}

POST /rounds

Creates a new round (only available in swiss system stages).

Resource URL

https://api.toornament.com/organizer/v2/rounds

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:admin scope (see Authorization)

Query Parameters

This endpoint does not have any query parameters.

Request Body

Round data

Example
{
    "stage_id": "618945443132178479",
    "group_id": "618983668512789184",
    "tournament_id": "378426939508809728"
}
Structure (object)
  • 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"

  • tournament_id
    string

    The id of the tournament that contains this round.

    Example: "378426939508809728"

Response

[201] Success

Example
{
    "id": "618983668512789184",
    "stage_id": "618945443132178479",
    "group_id": "618983668512789184",
    "tournament_id": "378426939508809728",
    "number": 2,
    "name": "1\/8th Finals",
    "closed": false,
    "settings": {
        "pairing_values": []
    },
    "match_settings": {
        "format": {
            "type": "best_of",
            "options": {
                "nb_match_sets": 3
            }
        }
    }
}
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"

  • tournament_id
    string

    The id of the tournament that contains this round.

    Example: "378426939508809728"

  • 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: {"pairing_values":[]}

  • match_settings
    object

    Settings that define the match configuration used in the round.

    Example: {"format":{"type":"best_of","options":{"nb_match_sets":3}}}

GET /rounds/{id}

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

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:result or organizer:admin scope (see Authorization)

Path parameters

  • id
    string

    The id of the round.

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",
    "tournament_id": "378426939508809728",
    "number": 2,
    "name": "1\/8th Finals",
    "closed": false,
    "settings": {
        "pairing_values": []
    },
    "match_settings": {
        "format": {
            "type": "best_of",
            "options": {
                "nb_match_sets": 3
            }
        }
    }
}
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"

  • tournament_id
    string

    The id of the tournament that contains this round.

    Example: "378426939508809728"

  • 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: {"pairing_values":[]}

  • match_settings
    object

    Settings that define the match configuration used in the round.

    Example: {"format":{"type":"best_of","options":{"nb_match_sets":3}}}

PATCH /rounds/{id}

Updates a single round.

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:admin scope (see Authorization)

Path parameters

  • id
    string

    The id of the round.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Round data

Example
{
    "name": "1\/8th Finals",
    "settings": {
        "pairing_values": []
    },
    "match_settings": {
        "format": {
            "type": "best_of",
            "options": {
                "nb_match_sets": 3
            }
        }
    }
}
Structure (object)
  • name
    string

    Optional

    The name of the round.

    Max. length: 30 characters

    Example: "1/8th Finals"

  • settings
    object

    Optional

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

    Example: {"pairing_values":[]}

  • match_settings
    object

    Optional

    Settings that define the match configuration used in the round.

    Example: {"format":{"type":"best_of","options":{"nb_match_sets":3}}}

Response

[200] Success

Example
{
    "id": "618983668512789184",
    "stage_id": "618945443132178479",
    "group_id": "618983668512789184",
    "tournament_id": "378426939508809728",
    "number": 2,
    "name": "1\/8th Finals",
    "closed": false,
    "settings": {
        "pairing_values": []
    },
    "match_settings": {
        "format": {
            "type": "best_of",
            "options": {
                "nb_match_sets": 3
            }
        }
    }
}
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"

  • tournament_id
    string

    The id of the tournament that contains this round.

    Example: "378426939508809728"

  • 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: {"pairing_values":[]}

  • match_settings
    object

    Settings that define the match configuration used in the round.

    Example: {"format":{"type":"best_of","options":{"nb_match_sets":3}}}

DELETE /rounds/{id}

Deletes a single round (only available for the last round of a swiss system stage).

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:admin scope (see Authorization)

Path parameters

  • id
    string

    The id of the round.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[204] Success

LegacyGET /tournaments/{tournament_id}/rounds

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

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": {
            "pairing_values": []
        }
    }
]
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: {"pairing_values":[]}

LegacyGET /tournaments/{tournament_id}/rounds/{id}

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

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.

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": {
        "pairing_values": []
    }
}
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: {"pairing_values":[]}