List Tournaments

GET

/tournaments.json

Get a list of tournaments organized by the owner of the API key or OAuth grantor.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://api.challonge.com/oauth/authorize

Token URL: https://api.challonge.com/oauth/token

Query Params

Header Params

Responses

🟢200OK

application/json

Tournament Response

Body

🟠401Unauthorized

🟠406Not Acceptable

🟠415Unsupported Media Type

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.challonge.com/v2.1/tournaments.json?community_id&page&per_page&state&type&created_after&created_before' \
--header 'Accept: application/json' \
--header 'Authorization-Type: v2' \
--header 'If-None-Match;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/vnd.api+json'

Response Example

200 - Example 1

[
    {
        "id": "30201",
        "type": "tournament",
        "attributes": {
            "name": "Rainbow Six: Siege Tournament",
            "url": "r6siege_tournament_xx",
            "tournament_type": "single elimination",
            "game_name": "Tom Clancy's Rainbow Six Siege",
            "private": false,
            "starts_at": "string",
            "description": "string",
            "notifications": {
                "upon_matches_open": true,
                "upon_tournament_ends": true
            },
            "match_options": {
                "consolation_matches_target_rank": 3,
                "accept_attachments": false
            },
            "registration_options": {
                "open_signup": false,
                "signup_cap": 0,
                "check_in_duration": 0
            },
            "seeding_options": {
                "hide_seeds": false,
                "sequential_pairings": false
            },
            "station_options": {
                "auto_assign": false,
                "only_start_matches_with_assigned_stations": false
            },
            "group_stage_enabled": false,
            "group_stage_options": {
                "stage_type": "round robin",
                "group_size": 4,
                "participant_count_to_advance_per_group": 2,
                "rr_iterations": 1,
                "ranked_by": "",
                "rr_pts_for_match_win": 1,
                "rr_pts_for_match_tie": 0.5,
                "rr_pts_for_game_win": 0,
                "rr_pts_for_game_tie": 0,
                "split_participants": false
            },
            "double_elimination_options": {
                "split_participants": false,
                "grand_finals_modifier": ""
            },
            "round_robin_options": {
                "iterations": 2,
                "ranking": "",
                "pts_for_game_win": 1,
                "pts_for_game_tie": 0,
                "pts_for_match_win": 1,
                "pts_for_match_tie": 0.5
            },
            "swiss_options": {
                "rounds": 2,
                "pts_for_game_win": 1,
                "pts_for_game_tie": 0,
                "pts_for_match_win": 1,
                "pts_for_match_tie": 0.5
            },
            "free_for_all_options": {
                "max_participants": 4
            }
        }
    }
]

Modified at 2025-11-04 17:45:07

Tournament States

Create Tournament