Get tournaments played by a user

GET

https://lichess.org/api/user/:username/tournament/played

GET

/api/user/:username/tournament/played

curl https://lichess.org/api/user/username/tournament/played \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "tournament": {
    "id": "cgWyxdzJ",
    "createdBy": "lichess",
    "system": "arena",
    "minutes": 120,
    "clock": {
      "limit": 300,
      "increment": 0
    },
    "rated": true,
    "fullName": "Eastern Blitz Arena",
    "nbPlayers": 1461,
    "variant": {
      "key": "standard",
      "name": "Standard",
      "short": "Std"
    },
    "startsAt": 1756188000000,
    "finishesAt": 1756195200000,
    "status": 30,
    "perf": {
      "key": "blitz",
      "name": "Blitz",
      "position": 1,
      "icon": ")"
    },
    "minRatedGames": {
      "nb": 15
    },
    "schedule": {
      "freq": "eastern",
      "speed": "blitz"
    }
  },
  "player": {
    "games": 1,
    "score": 2,
    "rank": 771
  }
}

Get all tournaments played by a given user. Tournaments are sorted by reverse chronological order of start date (last played first). Tournaments are streamed as ndjson. The stream is throttled, depending on who is making the request:

Anonymous request: 20 tournaments per second
OAuth2 authenticated request: 30 tournaments per second
Authenticated, downloading your own tournaments: 50 tournaments per second

Authentication

AuthorizationBearer

Read the introduction for how to make authenticated requests.

Path parameters

usernamestringRequired

The user whose played tournaments to fetch

Query parameters

nbintegerOptional>=1

Max number of tournaments to fetch

performancebooleanOptional

Include the player performance rating in the response, at some cost for the server.

Response

The list of tournaments played by the user.

tournamentobjectOptional

playerobjectOptional