---
title: "List Overwatch tournaments"
method: GET
path: "/ow/tournaments"
tags: ["OW tournaments"]
---

# List Overwatch tournaments

`GET /ow/tournaments`

List tournaments for the Overwatch videogame

## Query parameters

- `filter` FilterOverOwShortTournaments
  - `begin_at` TournamentBeginAt[]
  - `country` TournamentCountry[]
  - `detailed_stats` boolean — Whether the tournament is expected to have detailed statistics available
  - `end_at` TournamentEndAt[]
  - `has_bracket` boolean — Whether the tournament has a bracket
  - `id` TournamentID[]
  - `live_supported` boolean — Whether live is supported
  - `modified_at` TournamentModifiedAt[]
  - `name` TournamentName[]
  - `prizepool` TournamentPrizepool[]
  - `region` TournamentRegion[]
  - `serie_id` SerieID[]
  - `slug` TournamentSlug[]
  - `tier` TournamentTier[]
  - `videogame_title` union[] — A videogame title id or slug. Only for `/csgo/*`, `/codmw/*`, `/fifa/*` and `/ow/*` endpoints
    - union
      - integer
      - string
  - `winner_id` OpponentID[]
    - union
      - integer — ID of the player
      - integer — The ID of the team.
  - `winner_type` OpponentType[]
- `range` RangeOverOwShortTournaments
  - `begin_at` TournamentBeginAt[]
  - `country` TournamentCountry[]
  - `detailed_stats` TournamentDetailedStats[]
  - `end_at` TournamentEndAt[]
  - `has_bracket` TournamentHasBracket[]
  - `id` TournamentID[]
  - `modified_at` TournamentModifiedAt[]
  - `name` TournamentName[]
  - `prizepool` TournamentPrizepool[]
  - `region` TournamentRegion[]
  - `serie_id` SerieID[]
  - `slug` TournamentSlug[]
  - `tier` TournamentTier[]
  - `winner_id` OpponentID[]
    - union
      - integer — ID of the player
      - integer — The ID of the team.
  - `winner_type` OpponentType[]
- `sort` string[]
- `search` SearchOverOwShortTournaments
  - `country` string — Country code matching the location of the tournament according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the XK code is used for Kosovo. null if unknown
  - `name` string
  - `prizepool` string
  - `region` 'AF' | 'ASIA' | 'EEU' | 'ME' | 'NA' | 'OCE' | 'SA' | 'WEU' — Region acronym for the location of the tournament.
  - `slug` string
  - `tier` 'a' | 'b' | 'c' | 'd' | 's' | 'unranked' — The tier of the tournament, ranging from 'S' to 'Unranked'. Ranking 'S' > 'A' > 'B' > 'C' > 'D' > 'Unranked'
  - `winner_type` 'Player' | 'Team'
- `page` union
  - integer
  - object
    - `number` integer
    - `size` integer
- `per_page` integer

## Response `200`

A list of Overwatch tournaments

- ShortTournament[]
  - `begin_at` string, date-time, nullable, required
  - `country` string, nullable, required — Country code matching the location of the tournament according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the XK code is used for Kosovo. null if unknown
  - `detailed_stats` boolean, required — Whether the tournament is expected to have detailed statistics available
  - `end_at` string, date-time, nullable, required
  - `expected_roster` TournamentRosterItem[], required
    - `players` BasePlayer[], required
      - `active` boolean, required — Whether player is active
      - `age` number, nullable, required — Age of the player, `null` if unknown. When `birthday` is `null`, `age` is an approxiamation. Read more about [players' age](/docs/about-players-age) **Note**: This field is only present for users running the Historical plan or above.
      - `birthday` string, nullable, required — Birth day of the player, `YYYY-MM-DD` format. `null` if unknown. **Note**: This field is only present for users running the Historical plan or above.
      - `first_name` string, nullable, required — First name of the player. `null` if unknown
      - `id` integer, required — ID of the player
      - `image_url` string, uri, nullable, required — URL to the photo of the player. `null` if not available.
      - `last_name` string, nullable, required — Last name of the player. `null` if unknown
      - `modified_at` string, date-time, required
      - `name` string, required — Professional name of the player
      - `nationality` string, nullable, required — Country code matching the nationality of the player according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the `XK` code is used for Kosovo. `null` if unknown
      - `role` string, nullable, required — Role/position of the player. Field value varies depending on the video game.`null` if unknown. **Note**: role is only available for DotA 2, League of Legends, and Overwatch players. `null` for other video games.
      - `slug` string, nullable, required — Unique, human-readable identifier for the player. `id` and `slug` can be used interchangeably throughout the API.
    - `team` BaseTeam, required
      - `acronym` string, nullable, required
      - `dark_mode_image_url` string, uri, nullable, required — URL of the team logo
      - `id` integer, required — The ID of the team.
      - `image_url` string, uri, nullable, required — URL of the team logo
      - `location` string, nullable, required — The team's organization location
      - `modified_at` string, date-time, required
      - `name` string, required — The name of the team.
      - `slug` string, nullable, required
  - `has_bracket` boolean, required — Whether the tournament has a bracket
  - `id` integer, required
  - `league` BaseLeague, required
    - `id` integer, required
    - `image_url` string, uri, nullable, required
    - `modified_at` string, date-time, required
    - `name` string, required
    - `slug` string, required
    - `url` string, uri, nullable, required
  - `league_id` integer, required
  - `live_supported` boolean, required — Whether live is supported
  - `matches` BaseMatch[], required
    - `begin_at` string, date-time, nullable, required
    - `detailed_stats` boolean, required — Whether the match offers full stats
    - `draw` boolean, required — Whether result of the match is a draw
    - `end_at` string, date-time, nullable, required
    - `forfeit` boolean, required — Whether match was forfeited
    - `game_advantage` integer, nullable, required — ID of the opponent with a game advantage
    - `id` integer, required
    - `live` MatchLive, required
      - `opens_at` string, date-time, nullable, required
      - `supported` boolean, required — Whether live is supported
      - `url` string, uri, nullable, required
    - `low_latency_feed` boolean — Whether Whether the match is available via the Low Latency Feed. **Important:** this field is only present in the response for subscribers of a Low Latency Feed plan.
    - `match_type` 'all_games_played' | 'best_of' | 'custom' | 'first_to' | 'ow_best_of' | 'red_bull_home_ground', required
    - `modified_at` string, date-time, required
    - `name` string, required
    - `number_of_games` integer, required — Number of games
    - `original_scheduled_at` string, date-time, nullable, required
    - `rescheduled` boolean, nullable, required — Whether match has been rescheduled
    - `scheduled_at` string, date-time, nullable, required
    - `slug` string, nullable, required
    - `status` 'canceled' | 'finished' | 'not_started' | 'postponed' | 'running', required
    - `streams_list` Stream[], required
      - `embed_url` string, uri, nullable, required — URL to embed in an iframe.
      - `language` 'aa' | 'ab' | 'ae' | 'af' | 'ak' | 'am' | 'an' | 'ar' | 'as' | 'av' | 'ay' | 'az' | 'ba' | 'be' | 'bg' | 'bh' | 'bi' | 'bm' | 'bn' | 'bo' | 'br' | 'bs' | 'ca' | 'ce' | 'ch' | 'co' | 'cr' | 'cs' | 'cu' | 'cv' | 'cy' | 'da' | 'de' | 'dv' | 'dz' | 'ee' | 'el' | 'en' | 'eo' | 'es' | 'et' | 'eu' | 'fa' | 'ff' | 'fi' | 'fj' | 'fo' | 'fr' | 'fy' | 'ga' | 'gd' | 'gl' | 'gn' | 'gu' | 'gv' | 'ha' | 'he' | 'hi' | 'ho' | 'hr' | 'ht' | 'hu' | 'hy' | 'hz' | 'ia' | 'id' | 'ie' | 'ig' | 'ii' | 'ik' | 'io' | 'is' | 'it' | 'iu' | 'ja' | 'jv' | 'ka' | 'kg' | 'ki' | 'kj' | 'kk' | 'kl' | 'km' | 'kn' | 'ko' | 'kr' | 'ks' | 'ku' | 'kv' | 'kw' | 'ky' | 'la' | 'lb' | 'lg' | 'li' | 'ln' | 'lo' | 'lt' | 'lu' | 'lv' | 'mg' | 'mh' | 'mi' | 'mk' | 'ml' | 'mn' | 'mr' | 'ms' | 'mt' | 'my' | 'na' | 'nb' | 'nd' | 'ne' | 'ng' | 'nl' | 'nn' | 'no' | 'nr' | 'nv' | 'ny' | 'oc' | 'oj' | 'om' | 'or' | 'os' | 'pa' | 'pi' | 'pl' | 'ps' | 'pt' | 'qu' | 'rm' | 'rn' | 'ro' | 'ru' | 'rw' | 'sa' | 'sc' | 'sd' | 'se' | 'sg' | 'si' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sq' | 'sr' | 'ss' | 'st' | 'su' | 'sv' | 'sw' | 'ta' | 'te' | 'tg' | 'th' | 'ti' | 'tk' | 'tl' | 'tn' | 'to' | 'tr' | 'ts' | 'tt' | 'tw' | 'ty' | 'ug' | 'uk' | 'ur' | 'uz' | 've' | 'vi' | 'vo' | 'wa' | 'wo' | 'xh' | 'yi' | 'yo' | 'za' | 'zh' | 'zu', required — Language alpha-2 code according to ISO 649-1 standard.
      - `main` boolean, required — Whether it is the main stream. Main stream is always official.
      - `official` boolean, required — Whether it is an official broadcast.
      - `raw_url` string, uri, required — URL to the stream on host website.
    - `tournament_id` integer, required
    - `winner_id` union, required
      - integer, nullable — ID of the player
      - integer, nullable — The ID of the team.
    - `winner_type` 'Player' | 'Team', required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `prizepool` string, nullable, required
  - `region` 'AF' | 'ASIA' | 'EEU' | 'ME' | 'NA' | 'OCE' | 'SA' | 'WEU', nullable, required — Region acronym for the location of the tournament.
  - `serie` BaseSerie, required
    - `begin_at` string, date-time, nullable, required
    - `end_at` string, date-time, nullable, required
    - `full_name` string, required
    - `id` integer, required
    - `league_id` integer, required
    - `modified_at` string, date-time, required
    - `name` string, nullable, required
    - `season` string, nullable, required
    - `slug` string, required
    - `winner_id` union, required
      - integer, nullable — ID of the player
      - integer, nullable — The ID of the team.
    - `winner_type` 'Player' | 'Team', nullable, required
    - `year` integer, nullable, required
  - `serie_id` integer, required
  - `slug` string, required
  - `teams` BaseTeam[], required
    - `acronym` string, nullable, required
    - `dark_mode_image_url` string, uri, nullable, required — URL of the team logo
    - `id` integer, required — The ID of the team.
    - `image_url` string, uri, nullable, required — URL of the team logo
    - `location` string, nullable, required — The team's organization location
    - `modified_at` string, date-time, required
    - `name` string, required — The name of the team.
    - `slug` string, nullable, required
  - `tier` 'a' | 'b' | 'c' | 'd' | 's' | 'unranked', nullable, required — The tier of the tournament, ranging from 'S' to 'Unranked'. Ranking 'S' > 'A' > 'B' > 'C' > 'D' > 'Unranked'
  - `type` 'offline' | 'online' | 'online/offline', nullable, required — Location type for a tournament
  - `videogame` [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object] | [object Object], required
  - `videogame_title` object, nullable, required
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `videogame_id` 1 | 3 | 4 | 14 | 20 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36, required — A videogame ID
  - `winner_id` union, required
    - integer, nullable — ID of the player
    - integer, nullable — The ID of the team.
  - `winner_type` 'Player' | 'Team', nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/pandascore/apis/pandascore-rest-api.md) · [All operations](https://skmtc.net/pandascore/apis/pandascore-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandascore/pandascore-rest-api/versions/b3c347821e98/schema)
