🏆Tournament

Creating a Tournament

Create Tournament

POST [endpoint]/v3/tournament/create

Query Parameters

NameTypeDescription

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

NameTypeDescription

X-Api-Key*

String

API Key

Authorization

Bearer

Token Bearer

{
    "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

NameTypeDescription

tournament_id*

String

Tournament ID

Headers

NameTypeDescription

X-Api-Key*

String

API Key

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

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

NameTypeDescription

tournament_id*

String

Tournament ID

komo_username*

String

KOMO Username

player_slot*

Integer

Player Slot in Bracket

Headers

NameTypeDescription

X-Api-Key*

String

API Key

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

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

NameTypeDescription

tournament_id*

String

Tournament ID

match_no*

Integer

Match Number in Bracket

match_winner*

String

KOMO Username of Match Winner

Headers

NameTypeDescription

X-Api-Key*

String

API Key

{
    "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

NameTypeDescription

tournament_id*

String

Tournament ID

komo_username*

String

KOMO Username

player_slot*

Integer

Player Slot in Round Robin Schedule

Headers

NameTypeDescription

X-Api-Key*

String

API Key

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

Update Match Winner

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

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

Query Parameters

NameTypeDescription

tournament_id*

String

Tournament ID

match_id*

Integer

Match ID

match_winner*

String

KOMO Username of Match Winner

Headers

NameTypeDescription

X-Api-Key*

String

API Key

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

Last updated