🏆Tournament

Creating a Tournament

Create Tournament

POST [endpoint]/v3/tournament/create

Query Parameters

Name	Type	Description
game_id*	String	Game ID
tournament_name*	String	Tournament Name
description*	String	Tournament Description
start_time*	Datetime	Tournament Start Time
end_time*	Datetime	Tournament End Time
participant_limit*	Integer	Limit No. of Participant, see hint below
tournament_type*	String	leaderboard, single_elim, double_elim, round_robin

Headers

Name	Type	Description
X-Api-Key*	String	API Key
Authorization	Bearer	Token Bearer

200: OK Tournament Created

{
    "status": "success",
    "message": "Tournament 63804c7ede700 Created "
}

For single_elim and double_elim tournament type, participant_limit currently only support power of two numbers (2, 4, 8, 16, etc)

For leaderboard tournament type, use 0 for unlimited.

For round_robin tournament type,participant_limit must be even number.

Read Tournament Result

Also available as Player API

Read Tournament Result

GET [endpoint]/v3/tournament/read/[tournament_id]

Path Parameters

Name	Type	Description
tournament_id*	String	Tournament ID

Headers

Name	Type	Description
X-Api-Key*	String	API Key

200: OK Single Elimination

{
    "status": "success",
    "tournament_data": {
        "tournament_id": "6360e665edf88",
        "game_id": "DJAKSFNJSA",
        "tournament_name": "Test Tournament",
        "description": "lorem ipsum dolor sit amet",
        "start_time": "2022-11-03 00:00:00",
        "end_time": "2022-12-03 00:00:00",
        "tournament_type": "single_elim",
        "participant_limit": 8
    },
    "tournament_result": [
        {
            "id": 1,
            "round_no": 1,
            "match_no": 1,
            "komo_username": "leoleo",
            "status": "W",
            "placeholder": "Player Slot 1"
        },
        {
            "id": 2,
            "round_no": 1,
            "match_no": 1,
            "komo_username": "maymay",
            "status": "L",
            "placeholder": "Player Slot 2"
        },
        {
            "id": 3,
            "round_no": 1,
            "match_no": 2,
            "komo_username": "Aviabee",
            "status": "W",
            "placeholder": "Player Slot 3"
        },
        {
            "id": 4,
            "round_no": 1,
            "match_no": 2,
            "komo_username": "Kazky",
            "status": "L",
            "placeholder": "Player Slot 4"
        },
        {
            "id": 5,
            "round_no": 1,
            "match_no": 3,
            "komo_username": "bogei",
            "status": "L",
            "placeholder": "Player Slot 5"
        },
        {
            "id": 6,
            "round_no": 1,
            "match_no": 3,
            "komo_username": "bambang",
            "status": "W",
            "placeholder": "Player Slot 6"
        },
        {
            "id": 7,
            "round_no": 1,
            "match_no": 4,
            "komo_username": "yrdna",
            "status": "L",
            "placeholder": "Player Slot 7"
        },
        {
            "id": 8,
            "round_no": 1,
            "match_no": 4,
            "komo_username": "komochess",
            "status": "W",
            "placeholder": "Player Slot 8"
        },
        {
            "id": 9,
            "round_no": 2,
            "match_no": 5,
            "komo_username": "leoleo",
            "status": "L",
            "placeholder": "Winner Match #1"
        },
        {
            "id": 10,
            "round_no": 2,
            "match_no": 5,
            "komo_username": "Aviabee",
            "status": "W",
            "placeholder": "Winner Match #2"
        },
        {
            "id": 11,
            "round_no": 2,
            "match_no": 6,
            "komo_username": "bambang",
            "status": "L",
            "placeholder": "Winner Match #3"
        },
        {
            "id": 12,
            "round_no": 2,
            "match_no": 6,
            "komo_username": "komochess",
            "status": "W",
            "placeholder": "Winner Match #4"
        },
        {
            "id": 13,
            "round_no": 3,
            "match_no": 7,
            "komo_username": "Aviabee",
            "status": "W",
            "placeholder": "Winner Match #5"
        },
        {
            "id": 14,
            "round_no": 3,
            "match_no": 7,
            "komo_username": "komochess",
            "status": "L",
            "placeholder": "Winner Match #6"
        }
    ]
}

200: OK Round Robin

Managing Single Elimination Type Tournament

After creating tournament with tournament_type single_elim, we automatically create a bracket.

We also provide preview of the bracket here:

[endpoint]/view-tournament/[tournament_id]

Preview: Tournament #6360e665edf88

Asigning Player Into Player Slot

POST [endpoint]/v3/tournament/bracket/assign

To see availability of player slot in the bracket, find the null value on komo_username after getting /v2/tournament/read/[tournament_id]

Query Parameters

Name	Type	Description
tournament_id*	String	Tournament ID
komo_username*	String	KOMO Username
player_slot*	Integer	Player Slot in Bracket

Headers

Name	Type	Description
X-Api-Key*	String	API Key

403: Forbidden Slot already used

{
    "status": "error",
    "message": "Slot Already Occupied by komochess"
}

200: OK Slot assigned

Update Bracket Winner

POST [endpoint]/v3/tournament/bracket/update

Use this API to update match winner from a bracket match. It will also automatically move the winner into next bracket.

Query Parameters

Name	Type	Description
tournament_id*	String	Tournament ID
match_no*	Integer	Match Number in Bracket
match_winner*	String	KOMO Username of Match Winner

Headers

Name	Type	Description
X-Api-Key*	String	API Key

200: OK Bracket Updated

{
    "status": "success",
    "message": "Tournament Bracket Successfully Updated"
}

Managing Round Robin Type Tournament

After creating tournament with tournament_type round_robin, we automatically create a match schedule.

We also provide preview of the schedule here:

[endpoint]/view-round-robin/[tournament_id]

Preview: Tournament #63843297e5bbf

Asigning Player Into Player Slot

POST [endpoint]/v3/tournament/robin/assign

To see availability of player slot in the bracket, find the null value on komo_username_A after getting /v2/tournament/read/[tournament_id]

Query Parameters

Name	Type	Description
tournament_id*	String	Tournament ID
komo_username*	String	KOMO Username
player_slot*	Integer	Player Slot in Round Robin Schedule

Headers

Name	Type	Description
X-Api-Key*	String	API Key

403: Forbidden Slot already used

{
    "status": "error",
    "message": "Slot Already Occupied by Aviabee"
}

200: OK Slot assigned

Update Match Winner

POST [endpoint]/v3/tournament/robin/update

Use this API to update match winner from a round robin match

Query Parameters

Name	Type	Description
tournament_id*	String	Tournament ID
match_id*	Integer	Match ID
match_winner*	String	KOMO Username of Match Winner

Headers

Name	Type	Description
X-Api-Key*	String	API Key

200: OK Winner Updated

{
    "status": "success",
    "message": "Match Winner Updated"
}

403: Forbidden Winner is not on the match