Tournaments

GET /tournaments/{id}

Simple Access

Returns the data of a tournament including settings required to perform a registration such as registration settings and match reporting.

Resource URL

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

HTTP headers

Path parameters

  • id
    string

    A unique identifier of the tournament to retrieve.

Query Parameters

This endpoint doesn't have any query parameters.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

Example
{
    "id": "378426939508809728",
    "discipline": "my_discipline",
    "name": "My Weekly Tournament",
    "full_name": "My Weekly Tournament - Long title",
    "status": "running",
    "scheduled_date_start": "2015-09-06",
    "scheduled_date_end": "2015-09-07",
    "timezone": "America\/Sao_Paulo",
    "public": true,
    "size": 16,
    "participant_type": "team",
    "online": true,
    "location": "London",
    "country": "GB",
    "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$",
    "platforms": [
        "pc",
        "playstation4"
    ],
    "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"
    },
    "match_report_enabled": false,
    "registration_enabled": true,
    "registration_opening_datetime": "1999-01-01T00:00:00+00:00",
    "registration_closing_datetime": "1999-01-01T00:00:00+00:00",
    "registration_request_message": "For more info, go there -> []",
    "registration_user_mailer_enabled": true,
    "registration_terms_enabled": true,
    "registration_terms_url": "http:\/\/download.my\/terms.pdf",
    "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"
}
Structure (object)
  • id
    string

    A unique identifier for the tournament

    Example: "378426939508809728"

  • discipline
    string

    A unique string identifier of a discipline

    Example: "my_discipline"

  • name
    string

    The name of the tournament (maximum 30 characters)

    Example: "My Weekly Tournament"

  • full_name
    string|null

    The complete name of the tournament (maximum 80 characters)

    Example: "My Weekly Tournament - Long title"

  • status
    string

    The status of the tournament

    Possible values: setup, running, completed

  • scheduled_date_start
    date|null

    A starting date in ISO 8601 format (only the date part)

    Pattern: YYYY-MM-DD

    Example: "2015-09-06"

  • scheduled_date_end
    date|null

    An ending date in ISO 8601 format (only the date part)

    Pattern: YYYY-MM-DD

    Example: "2015-09-07"

  • timezone
    string|null

    A time zone represented using the IANA tz database

    Example: "America/Sao_Paulo"

  • public
    boolean

    Whether the tournament is published

    Example: true

  • size
    integer

    The expected number of participants in the tournament

    Example: 16

  • participant_type
    string

    The type of participants who plays in the tournament

    Possible values: team, single

  • online
    boolean

    Whether the tournament is played on internet

    Example: true

  • location
    string|null

    A region, city, address or place of interest

    Example: "London"

  • country
    string|null

    A country where the tournament is played. Its possible that some code is not supported.

    Format: ISO 3166-1 alpha-2

    Example: "GB"

  • organization
    string|null

    The name of the organizer whether it is an individual, group, association or company

    Example: "Avery Bullock"

  • contact
    string

    The email address to contact the organizer

    Example: "contact@toornament.com"

  • discord
    string

    The discord URL to contact the organizer or participants

    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 (maximum 1,500 characters)

    Example: "My description \n on multiple lines"

  • rules
    string|null

    A description of the tournament's rules (maximum 10,000 characters)

    Example: "My rules \n on multiple lines"

  • prize
    string|null

    A description of the tournament's prizes (maximum 1,500 characters)

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

  • team_size_min
    integer

    Optional

    The smallest possible team size (only if a team tournament)

  • team_size_max
    integer

    Optional

    The largest possible team size (only if a team tournament)

  • platforms
    array[string]|null

    A list of platforms on which the tournament can 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

  • logo
    object|null

    The tournament logo in every available format.

    Example: {"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"}

  • match_report_enabled
    boolean

    Whether the participant's match report is enabled

    Example: false

  • registration_enabled
    boolean

    Whether the registration is enabled

    Example: true

  • registration_opening_datetime
    datetime

    The opening date of the registrations

    Format: RFC 3339 (combined date, time and utc offset)

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

  • registration_closing_datetime
    datetime

    The closing date of the registrations

    Format: RFC 3339 (combined date, time and utc offset)

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

  • registration_request_message
    string

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

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

  • registration_user_mailer_enabled
    boolean

    Whether to notify participants when their registration status changes.

    Example: true

  • registration_terms_enabled
    boolean

    Whether custom 'terms of use' are required

    Example: true

  • registration_terms_url
    string

    The url of the custom 'terms of use'

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

  • check_in_enabled
    boolean

    Whether to enable the check-in.

    Example: true

  • check_in_participant_enabled
    boolean

    Whether to enable the check-in for participants.

    Example: true

  • check_in_participant_start_datetime
    datetime

    The date/time of the start of the participant check-in

    Format: RFC 3339 (combined date, time and utc offset)

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

  • check_in_participant_end_datetime
    datetime

    The date/time of the start of the participant check-in.

    Format: RFC 3339 (combined date, time and utc offset)

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