GET/tournaments

This endpoint retrieves a list of tournaments associated with the authenticated user. You can use query parameters to filter and paginate the results.

Note

This endpoint requires an API token (not a public API key). To find public tournaments of other organizers you need a public API key: pick the organizer via GET /organizers and use GET /organizers/:organizerId/tournaments.

Valid state values:

• planned: Tournament options are still being edited
• pre-registration: Tournament is in pre-registration phase
• check-in: Tournament is in check-in phase
• ready: Tournament is ready to start
• running: Tournament is currently running
• finished: Tournament has ended
• cancelled: Tournament has been cancelled

Filtering by state

• Pass one state (state=running) or several, either comma-separated (state=running,finished) or repeated (state=running&state=finished).
• If no state is specified, tournaments in all states will be returned.
• An unknown state is a 400.

Filtering by start date

• from and to filter on the tournament start date (the date field of the response). Both are optional and can be used alone, for example only from for everything from a day on, or only to for everything up to a day.
• Values are ISO 8601, either a date (2026-09-15) or a date-time (2026-09-15T18:00:00Z).
• from is inclusive. A date-only to includes the whole day (UTC), a date-time to is an inclusive instant.
• Tournaments without a start date are not returned while a date filter is set.
• An invalid date is a 400.

Notes

• The limit and offset parameters can be used together for pagination. limit must be between 1 and 100, offset at least 0; anything else is a 400.
• Tournaments are typically sorted by start date, with the most recent first.
• organizer is your own result page; it is missing if you have none.

Parameters

Parameter	In	Example
limit	query	25
offset	query	0
state	query	running,finished
from	query	2026-09-01
to	query	2026-09-30

Responses

200

[
  {
    "id": "tio:nBwyxswp26Vfk",
    "name": "MonsterDYP",
    "disciplines": [
      {
        "id": "tio:Xm6bweBQmhni8",
        "shortName": "D1",
        "name": "Discipline 1",
        "modes": [
          "monster_dyp"
        ],
        "entryType": "monster_dyp"
      }
    ],
    "date": "2024-08-08T13:22:10.101Z",
    "state": "running",
    "numPlayers": 20,
    "numTeams": 0,
    "organizer": {
      "id": "V1StGXR8_Z5jdHi6B-myT",
      "slug": "kixx",
      "name": "Kixx Hamburg"
    }
  },
  ...
]