Tournaments

GET /tournaments

Authorized Access

Returns tournaments you organize with all organizer-specific data.

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:view scope (see Authorization)

  • Range
    string

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

    Example: tournaments=0-49

Query Parameters

  • disciplines
    string

    One or several disciplines to filter.

    Example: counterstrike_go,fifa17

  • statuses
    string

    One or several tournament statuses to filter.

    Possible values: pending, running, completed

    Example: pending,running

  • scheduled_before
    string

    An ISO 8601 date (only the date part, with YYYY-MM-DD pattern) to include all tournaments scheduled to take place before or at the date.

    Format: date

  • scheduled_after
    string

    An ISO 8601 date (only the date part, with YYYY-MM-DD pattern) to include all tournaments scheduled to take place after or at the date.

    Format: date

  • countries
    string

    One or several countries to filter, with format ISO 3166-1 alpha-2 country codes.

    Example: US,CA

  • platforms
    string

    One or several platforms to filter.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

    Example: pc,xbox_one,playstation4

  • is_online
    integer

    Whether the tournament is played online.

    Possible values: 0, 1

  • archived
    integer

    Whether to include archived tournaments.

    Possible values: 0, 1

  • custom_user_identifier
    string

    An external custom user identifier. Use the format that suits your needs.

    Example: acme:account:1234

  • sort
    string

    Sorts the collection in a particular order. "scheduled_asc" sorts the tournaments by scheduled date from the oldest to the most recent one; "scheduled_desc" sorts the tournaments by scheduled date from the most recent to the oldest one.

    Possible values: scheduled_asc, scheduled_desc

    Default: scheduled_asc

Request Body

This endpoint does not require a request body.

Response

[206] Tournaments retrieved.

Example
[
    {
        "name": "My Weekly Tournament",
        "full_name": "My Weekly Tournament - Long title",
        "scheduled_date_start": "2015-09-06",
        "scheduled_date_end": "2015-09-07",
        "timezone": "America\/Sao_Paulo",
        "public": true,
        "size": 16,
        "online": true,
        "location": "London",
        "country": "GB",
        "logo": {
            "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
            "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
            "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
            "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
        },
        "registration_enabled": true,
        "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
        "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
        "id": "378426939508809728",
        "discipline": "my_discipline",
        "status": "running",
        "platforms": [
            "pc"
        ]
    }
]
Structure (collection)
  • name
    string

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset)

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset)

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • id
    string

    The unique identifier of the tournament.

    Example: "378426939508809728"

  • discipline
    string

    A unique identifier of the tournament’s discipline.

    Example: "my_discipline"

  • status
    string

    The status of the tournament.

    Possible values: pending, running, completed

  • platforms
    array[string]

    The platform on which the tournament will be played.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

POST /tournaments

Authorized Access

Creates a new tournament.

Resource URL

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

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

Tournament data

Example
{
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "online": true,
    "location": "London",
    "country": "GB",
    "logo": {
        "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
        "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
        "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
        "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
    },
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "organization": "Avery Bullock",
    "contact": "contact@toornament.com",
    "discord": "https:\/\/discord.gg\/qWbbkuY",
    "website": "http:\/\/www.toornament.com",
    "description": "My description \n on multiple lines",
    "rules": "My rules \n on multiple lines",
    "prize": "1 - 10,000$ \n 2 - 5,000$",
    "match_report_enabled": false,
    "registration_request_message": "For more info, go there -> []",
    "check_in_enabled": true,
    "check_in_participant_enabled": true,
    "check_in_participant_start_datetime": "1999-01-01T00:00:00+00:00",
    "check_in_participant_end_datetime": "1999-01-01T00:00:00+00:00",
    "archived": false,
    "registration_acceptance_message": "You must now follow the next steps -> []",
    "registration_refusal_message": "Sorry, your registration has been refused.",
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "discipline": "counterstrike_go",
    "participant_type": "single",
    "platforms": [
        "pc"
    ],
    "team_size_min": 2,
    "team_size_max": 5
}
Structure (object)
  • name
    string

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    Optional

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    Optional

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    Optional

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Optional

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Optional

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    Optional

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    Optional

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    Optional

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Optional

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    Optional

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    Optional

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • organization
    string|null

    Optional

    The name of the organizer, be it an individual, group, association or company.

    Example: "Avery Bullock"

  • contact
    string|null

    Optional

    The email address to contact the organizer.

    Example: "contact@toornament.com"

  • discord
    string|null

    Optional

    Invite URL to the tournament Discord server.

    Example: "https://discord.gg/qWbbkuY"

  • website
    string|null

    Optional

    The tournament's official website URL.

    Example: "http://www.toornament.com"

  • description
    string|null

    Optional

    A description of the tournament.

    Max. length: 1,500 characters

    Example: "My description \n on multiple lines"

  • rules
    string|null

    Optional

    The rules of the tournament.

    Max. length: 10,000 characters

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    Optional

    The prizes of the tournament.

    Max. length: 1,500 characters

    Example: "1 - 10,000$ \n 2 - 5,000$"

  • match_report_enabled
    boolean

    Optional

    Whether the participant's match report is enabled or not.

    Example: false

  • registration_request_message
    string|null

    Optional

    The message provided by the organizer for people who want to register.

    Example: "For more info, go there -> []"

  • check_in_enabled
    boolean

    Optional

    Whether to enable the check-in or not.

    Example: true

  • check_in_participant_enabled
    boolean

    Optional

    Whether to enable the check-in for participants or not.

    Example: true

  • check_in_participant_start_datetime
    string|null

    Optional

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • check_in_participant_end_datetime
    string|null

    Optional

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • archived
    boolean

    Optional

    Whether the tournament is archived or not.

    Example: false

  • registration_acceptance_message
    string|null

    Optional

    The message sent to a player when his registration is accepted.

    Example: "You must now follow the next steps -> []"

  • registration_refusal_message
    string|null

    Optional

    The message sent to a player when his registration is refused.

    Example: "Sorry, your registration has been refused."

  • registration_terms_enabled
    boolean

    Optional

    Whether custom 'terms of use' are required.

    Example: true

  • registration_terms_url
    string|null

    Optional

    If enabled, the URL of the custom 'terms of use'.

    Example: "http://download.my/terms.pdf"

  • discipline
    string

    A unique identifier of the tournament’s discipline.

    Example: "counterstrike_go"

  • participant_type
    string

    The type of participants that play in the tournament.

    Possible values: team, single

  • platforms
    array[string]

    The platform on which the tournament will be played.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

  • team_size_min
    integer

    Optional

    The smallest possible team size (only if the tournament participant type is “team”).

    Example: 2

  • team_size_max
    integer

    Optional

    The largest possible team size (only if the tournament participant type is “team”).

    Example: 5

Response

[201] Tournament created.

Example
{
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "online": true,
    "location": "London",
    "country": "GB",
    "logo": {
        "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
        "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
        "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
        "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
    },
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "organization": "Avery Bullock",
    "contact": "contact@toornament.com",
    "discord": "https:\/\/discord.gg\/qWbbkuY",
    "website": "http:\/\/www.toornament.com",
    "description": "My description \n on multiple lines",
    "rules": "My rules \n on multiple lines",
    "prize": "1 - 10,000$ \n 2 - 5,000$",
    "match_report_enabled": false,
    "registration_request_message": "For more info, go there -> []",
    "check_in_enabled": true,
    "check_in_participant_enabled": true,
    "check_in_participant_start_datetime": "1999-01-01T00:00:00+00:00",
    "check_in_participant_end_datetime": "1999-01-01T00:00:00+00:00",
    "archived": false,
    "registration_acceptance_message": "You must now follow the next steps -> []",
    "registration_refusal_message": "Sorry, your registration has been refused.",
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "id": "378426939508809728",
    "discipline": "my_discipline",
    "status": "running",
    "participant_type": "single",
    "platforms": [
        "pc"
    ],
    "featured": true,
    "registration_notification_enabled": true,
    "team_size_min": 2,
    "team_size_max": 5
}
Structure (object)
  • name
    string

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • organization
    string|null

    The name of the organizer, be it an individual, group, association or company.

    Example: "Avery Bullock"

  • contact
    string|null

    The email address to contact the organizer.

    Example: "contact@toornament.com"

  • discord
    string|null

    Invite URL to the tournament Discord server.

    Example: "https://discord.gg/qWbbkuY"

  • website
    string|null

    The tournament's official website URL.

    Example: "http://www.toornament.com"

  • description
    string|null

    A description of the tournament.

    Max. length: 1,500 characters

    Example: "My description \n on multiple lines"

  • rules
    string|null

    The rules of the tournament.

    Max. length: 10,000 characters

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    The prizes of the tournament.

    Max. length: 1,500 characters

    Example: "1 - 10,000$ \n 2 - 5,000$"

  • match_report_enabled
    boolean

    Whether the participant's match report is enabled or not.

    Example: false

  • registration_request_message
    string|null

    The message provided by the organizer for people who want to register.

    Example: "For more info, go there -> []"

  • check_in_enabled
    boolean

    Whether to enable the check-in or not.

    Example: true

  • check_in_participant_enabled
    boolean

    Whether to enable the check-in for participants or not.

    Example: true

  • check_in_participant_start_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • check_in_participant_end_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • archived
    boolean

    Whether the tournament is archived or not.

    Example: false

  • registration_acceptance_message
    string|null

    The message sent to a player when his registration is accepted.

    Example: "You must now follow the next steps -> []"

  • registration_refusal_message
    string|null

    The message sent to a player when his registration is refused.

    Example: "Sorry, your registration has been refused."

  • registration_terms_enabled
    boolean

    Whether custom 'terms of use' are required.

    Example: true

  • registration_terms_url
    string|null

    If enabled, the URL of the custom 'terms of use'.

    Example: "http://download.my/terms.pdf"

  • id
    string

    The unique identifier of the tournament.

    Example: "378426939508809728"

  • discipline
    string

    A unique identifier of the tournament’s discipline.

    Example: "my_discipline"

  • status
    string

    The status of the tournament.

    Possible values: pending, running, completed

  • participant_type
    string

    The type of participants that play in the tournament.

    Possible values: team, single

  • platforms
    array[string]

    The platform on which the tournament will be played.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

  • featured
    boolean

    Whether the tournament is featured or not.

    Example: true

  • registration_notification_enabled
    boolean

    Whether to notify organizers when new registrations occur or not.

    Example: true

  • team_size_min
    integer

    The smallest possible team size (only if the tournament participant type is “team”).

    Example: 2

  • team_size_max
    integer

    The largest possible team size (only if the tournament participant type is “team”).

    Example: 5

GET /tournaments/{id}

Authorized Access

Returns a tournament identified with the given id with all organizer-specific data.

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:view scope (see Authorization)

Path parameters

  • id
    string

    The id of the tournament.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[200] Tournament retrieved.

Example
{
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "online": true,
    "location": "London",
    "country": "GB",
    "logo": {
        "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
        "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
        "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
        "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
    },
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "organization": "Avery Bullock",
    "contact": "contact@toornament.com",
    "discord": "https:\/\/discord.gg\/qWbbkuY",
    "website": "http:\/\/www.toornament.com",
    "description": "My description \n on multiple lines",
    "rules": "My rules \n on multiple lines",
    "prize": "1 - 10,000$ \n 2 - 5,000$",
    "match_report_enabled": false,
    "registration_request_message": "For more info, go there -> []",
    "check_in_enabled": true,
    "check_in_participant_enabled": true,
    "check_in_participant_start_datetime": "1999-01-01T00:00:00+00:00",
    "check_in_participant_end_datetime": "1999-01-01T00:00:00+00:00",
    "archived": false,
    "registration_acceptance_message": "You must now follow the next steps -> []",
    "registration_refusal_message": "Sorry, your registration has been refused.",
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "id": "378426939508809728",
    "discipline": "my_discipline",
    "status": "running",
    "participant_type": "single",
    "platforms": [
        "pc"
    ],
    "featured": true,
    "registration_notification_enabled": true,
    "team_size_min": 2,
    "team_size_max": 5
}
Structure (object)
  • name
    string

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • organization
    string|null

    The name of the organizer, be it an individual, group, association or company.

    Example: "Avery Bullock"

  • contact
    string|null

    The email address to contact the organizer.

    Example: "contact@toornament.com"

  • discord
    string|null

    Invite URL to the tournament Discord server.

    Example: "https://discord.gg/qWbbkuY"

  • website
    string|null

    The tournament's official website URL.

    Example: "http://www.toornament.com"

  • description
    string|null

    A description of the tournament.

    Max. length: 1,500 characters

    Example: "My description \n on multiple lines"

  • rules
    string|null

    The rules of the tournament.

    Max. length: 10,000 characters

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    The prizes of the tournament.

    Max. length: 1,500 characters

    Example: "1 - 10,000$ \n 2 - 5,000$"

  • match_report_enabled
    boolean

    Whether the participant's match report is enabled or not.

    Example: false

  • registration_request_message
    string|null

    The message provided by the organizer for people who want to register.

    Example: "For more info, go there -> []"

  • check_in_enabled
    boolean

    Whether to enable the check-in or not.

    Example: true

  • check_in_participant_enabled
    boolean

    Whether to enable the check-in for participants or not.

    Example: true

  • check_in_participant_start_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • check_in_participant_end_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • archived
    boolean

    Whether the tournament is archived or not.

    Example: false

  • registration_acceptance_message
    string|null

    The message sent to a player when his registration is accepted.

    Example: "You must now follow the next steps -> []"

  • registration_refusal_message
    string|null

    The message sent to a player when his registration is refused.

    Example: "Sorry, your registration has been refused."

  • registration_terms_enabled
    boolean

    Whether custom 'terms of use' are required.

    Example: true

  • registration_terms_url
    string|null

    If enabled, the URL of the custom 'terms of use'.

    Example: "http://download.my/terms.pdf"

  • id
    string

    The unique identifier of the tournament.

    Example: "378426939508809728"

  • discipline
    string

    A unique identifier of the tournament’s discipline.

    Example: "my_discipline"

  • status
    string

    The status of the tournament.

    Possible values: pending, running, completed

  • participant_type
    string

    The type of participants that play in the tournament.

    Possible values: team, single

  • platforms
    array[string]

    The platform on which the tournament will be played.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

  • featured
    boolean

    Whether the tournament is featured or not.

    Example: true

  • registration_notification_enabled
    boolean

    Whether to notify organizers when new registrations occur or not.

    Example: true

  • team_size_min
    integer

    The smallest possible team size (only if the tournament participant type is “team”).

    Example: 2

  • team_size_max
    integer

    The largest possible team size (only if the tournament participant type is “team”).

    Example: 5

PATCH /tournaments/{id}

Authorized Access

Updates one or several fields of one of your tournaments.

Resource URL

https://api.toornament.com/organizer/v2/tournaments/{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 tournament.

Query Parameters

This endpoint does not have any query parameters.

Request Body

Tournament data.

Example
{
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "online": true,
    "location": "London",
    "country": "GB",
    "logo": {
        "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
        "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
        "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
        "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
    },
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "organization": "Avery Bullock",
    "contact": "contact@toornament.com",
    "discord": "https:\/\/discord.gg\/qWbbkuY",
    "website": "http:\/\/www.toornament.com",
    "description": "My description \n on multiple lines",
    "rules": "My rules \n on multiple lines",
    "prize": "1 - 10,000$ \n 2 - 5,000$",
    "match_report_enabled": false,
    "registration_request_message": "For more info, go there -> []",
    "check_in_enabled": true,
    "check_in_participant_enabled": true,
    "check_in_participant_start_datetime": "1999-01-01T00:00:00+00:00",
    "check_in_participant_end_datetime": "1999-01-01T00:00:00+00:00",
    "archived": false,
    "registration_acceptance_message": "You must now follow the next steps -> []",
    "registration_refusal_message": "Sorry, your registration has been refused.",
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "team_size_min": 2,
    "team_size_max": 5
}
Structure (object)
  • name
    string

    Optional

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    Optional

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    Optional

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    Optional

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    Optional

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Optional

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    Optional

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Optional

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    Optional

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    Optional

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    Optional

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Optional

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    Optional

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    Optional

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • organization
    string|null

    Optional

    The name of the organizer, be it an individual, group, association or company.

    Example: "Avery Bullock"

  • contact
    string|null

    Optional

    The email address to contact the organizer.

    Example: "contact@toornament.com"

  • discord
    string|null

    Optional

    Invite URL to the tournament Discord server.

    Example: "https://discord.gg/qWbbkuY"

  • website
    string|null

    Optional

    The tournament's official website URL.

    Example: "http://www.toornament.com"

  • description
    string|null

    Optional

    A description of the tournament.

    Max. length: 1,500 characters

    Example: "My description \n on multiple lines"

  • rules
    string|null

    Optional

    The rules of the tournament.

    Max. length: 10,000 characters

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    Optional

    The prizes of the tournament.

    Max. length: 1,500 characters

    Example: "1 - 10,000$ \n 2 - 5,000$"

  • match_report_enabled
    boolean

    Optional

    Whether the participant's match report is enabled or not.

    Example: false

  • registration_request_message
    string|null

    Optional

    The message provided by the organizer for people who want to register.

    Example: "For more info, go there -> []"

  • check_in_enabled
    boolean

    Optional

    Whether to enable the check-in or not.

    Example: true

  • check_in_participant_enabled
    boolean

    Optional

    Whether to enable the check-in for participants or not.

    Example: true

  • check_in_participant_start_datetime
    string|null

    Optional

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • check_in_participant_end_datetime
    string|null

    Optional

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • archived
    boolean

    Optional

    Whether the tournament is archived or not.

    Example: false

  • registration_acceptance_message
    string|null

    Optional

    The message sent to a player when his registration is accepted.

    Example: "You must now follow the next steps -> []"

  • registration_refusal_message
    string|null

    Optional

    The message sent to a player when his registration is refused.

    Example: "Sorry, your registration has been refused."

  • registration_terms_enabled
    boolean

    Optional

    Whether custom 'terms of use' are required.

    Example: true

  • registration_terms_url
    string|null

    Optional

    If enabled, the URL of the custom 'terms of use'.

    Example: "http://download.my/terms.pdf"

  • team_size_min
    integer

    Optional

    The smallest possible team size (only if the tournament participant type is “team”).

    Example: 2

  • team_size_max
    integer

    Optional

    The largest possible team size (only if the tournament participant type is “team”).

    Example: 5

Response

[200] Success.

Example
{
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "online": true,
    "location": "London",
    "country": "GB",
    "logo": {
        "logo_small": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_small",
        "logo_medium": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_medium",
        "logo_large": "https:\/\/www.toornament.com\/media\/file\/123456\/logo_large",
        "original": "https:\/\/www.toornament.com\/media\/file\/123456\/original"
    },
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "organization": "Avery Bullock",
    "contact": "contact@toornament.com",
    "discord": "https:\/\/discord.gg\/qWbbkuY",
    "website": "http:\/\/www.toornament.com",
    "description": "My description \n on multiple lines",
    "rules": "My rules \n on multiple lines",
    "prize": "1 - 10,000$ \n 2 - 5,000$",
    "match_report_enabled": false,
    "registration_request_message": "For more info, go there -> []",
    "check_in_enabled": true,
    "check_in_participant_enabled": true,
    "check_in_participant_start_datetime": "1999-01-01T00:00:00+00:00",
    "check_in_participant_end_datetime": "1999-01-01T00:00:00+00:00",
    "archived": false,
    "registration_acceptance_message": "You must now follow the next steps -> []",
    "registration_refusal_message": "Sorry, your registration has been refused.",
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "id": "378426939508809728",
    "discipline": "my_discipline",
    "status": "running",
    "participant_type": "single",
    "platforms": [
        "pc"
    ],
    "featured": true,
    "registration_notification_enabled": true,
    "team_size_min": 2,
    "team_size_max": 5
}
Structure (object)
  • name
    string

    The name of the tournament.

    Max. length: 30 characters

    Example: "My Weekly Tournament"

  • full_name
    string|null

    The complete name of the tournament.

    Max. length: 80 characters

    Example: "My Weekly Tournament - Long title"

  • scheduled_date_start
    string|null

    A starting date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-06"

  • scheduled_date_end
    string|null

    An ending date in ISO 8601 format (only the date part, with YYYY-MM-DD pattern).

    Format: date

    Example: "2015-09-07"

  • timezone
    string

    A time zone from the IANA tz database.

    Example: "America/Sao_Paulo"

  • public
    boolean

    Whether the tournament is published or not.

    Example: true

  • size
    integer

    The expected number of participants in the tournament.

    Example: 16

  • online
    boolean|null

    Whether the tournament is played on internet or not.

    Example: true

  • location
    string|null

    The region, city, address or place of interest where the tournament is held.

    Example: "London"

  • country
    string|null

    The country where the tournament is played. Some codes may not be supported. (format is ISO 3166-1 alpha-2)

    Example: "GB"

  • logo
    object|null

    The tournament logo in every available format.

  • registration_enabled
    boolean

    Whether the registration process is enabled.

    Example: true

  • registration_opening_datetime
    string|null

    The opening date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • registration_closing_datetime
    string|null

    The closing date of the registrations in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • organization
    string|null

    The name of the organizer, be it an individual, group, association or company.

    Example: "Avery Bullock"

  • contact
    string|null

    The email address to contact the organizer.

    Example: "contact@toornament.com"

  • discord
    string|null

    Invite URL to the tournament Discord server.

    Example: "https://discord.gg/qWbbkuY"

  • website
    string|null

    The tournament's official website URL.

    Example: "http://www.toornament.com"

  • description
    string|null

    A description of the tournament.

    Max. length: 1,500 characters

    Example: "My description \n on multiple lines"

  • rules
    string|null

    The rules of the tournament.

    Max. length: 10,000 characters

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    The prizes of the tournament.

    Max. length: 1,500 characters

    Example: "1 - 10,000$ \n 2 - 5,000$"

  • match_report_enabled
    boolean

    Whether the participant's match report is enabled or not.

    Example: false

  • registration_request_message
    string|null

    The message provided by the organizer for people who want to register.

    Example: "For more info, go there -> []"

  • check_in_enabled
    boolean

    Whether to enable the check-in or not.

    Example: true

  • check_in_participant_enabled
    boolean

    Whether to enable the check-in for participants or not.

    Example: true

  • check_in_participant_start_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • check_in_participant_end_datetime
    string|null

    The date and time of the participant check-in start, in RFC 3339 format (combined date, time and utc offset).

    Format: datetime

    Example: "1999-01-01T00:00:00+00:00"

  • archived
    boolean

    Whether the tournament is archived or not.

    Example: false

  • registration_acceptance_message
    string|null

    The message sent to a player when his registration is accepted.

    Example: "You must now follow the next steps -> []"

  • registration_refusal_message
    string|null

    The message sent to a player when his registration is refused.

    Example: "Sorry, your registration has been refused."

  • registration_terms_enabled
    boolean

    Whether custom 'terms of use' are required.

    Example: true

  • registration_terms_url
    string|null

    If enabled, the URL of the custom 'terms of use'.

    Example: "http://download.my/terms.pdf"

  • id
    string

    The unique identifier of the tournament.

    Example: "378426939508809728"

  • discipline
    string

    A unique identifier of the tournament’s discipline.

    Example: "my_discipline"

  • status
    string

    The status of the tournament.

    Possible values: pending, running, completed

  • participant_type
    string

    The type of participants that play in the tournament.

    Possible values: team, single

  • platforms
    array[string]

    The platform on which the tournament will be played.

    Possible values: pc, playstation4, xbox_one, nintendo_switch, mobile, playstation3, playstation2, playstation1, ps_vita, psp, xbox360, xbox, wii_u, wii, gamecube, nintendo64, snes, nes, dreamcast, saturn, megadrive, master_system, 3ds, ds, game_boy, neo_geo, other_platform, not_video_game

  • featured
    boolean

    Whether the tournament is featured or not.

    Example: true

  • registration_notification_enabled
    boolean

    Whether to notify organizers when new registrations occur or not.

    Example: true

  • team_size_min
    integer

    The smallest possible team size (only if the tournament participant type is “team”).

    Example: 2

  • team_size_max
    integer

    The largest possible team size (only if the tournament participant type is “team”).

    Example: 5

DELETE /tournaments/{id}

Authorized Access

Deletes your tournament identified by the given id.

Resource URL

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

HTTP headers

  • X-Api-Key
    string

    API key of your application (see Authentication)

  • Authorization
    string

    Access token with organizer:delete scope (see Authorization)

Path parameters

  • id
    string

    The id of the tournament.

Query Parameters

This endpoint does not have any query parameters.

Request Body

This endpoint does not require a request body.

Response

[204] Success.