Tournament Discovery

Discover public tournaments

Changed on

Returns publicly listed tournaments, featured entries first. Unlisted and draft tournaments are never included, whoever asks. Requires tournaments.tournament_public:read.

post/tournaments/discover

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/tournaments/discover
  • Auth
    HTTP bearer

Request body

searchstring

Case-insensitive name substring. Ignored below 2 characters.

gameIdstring

Filter to a single game by Convex ID.

format'SINGLE_ELIMINATION' | 'DOUBLE_ELIMINATION' | 'ROUND_ROBIN' | 'SWISS'

Bracket format of a tournament.

status'DRAFT' | 'REGISTRATION_OPEN' | 'REGISTRATION_CLOSED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED'

Lifecycle status of a tournament.

pageinteger

1-based page number.

limitinteger

Page size, 1-50.

Response

A page of publicly listed tournaments.

countinteger required

Number of tournaments in this page.

totalinteger required

Total tournaments matching the filters.

pageinteger required

Echo of the requested 1-based page.

limitinteger required

Echo of the applied page size.

timestampstring required

Response generation time (ISO 8601).

Changes