# 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, 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

### Notes
- If no state is specified, tournaments in all states will be returned.
- 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` |

## Responses

```json
[
  {
    "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"
    }
  },
  ...
]
```