LIlichess
Tournaments (Arena)

Get tournaments created by a user

Get all tournaments created by a given user. Tournaments are sorted by reverse chronological order of start date (last starting 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
get/api/user/{username}/tournament/created

Request

  • Base URL
    https://lichess.org
  • URL
    https://lichess.org/api/user/{username}/tournament/created
  • Auth
    OAuth 2
    Authorization code: https://lichess.org/oauth
    Token URL: https://lichess.org/api/token

Path parameters

usernamestring required

The user whose created tournaments to fetch

Query parameters

nbinteger

Max number of tournaments to fetch

status10 | 20 | 30

Include tournaments in the given status: "Created" (10), "Started" (20), "Finished" (30) You can add this parameter more than once to include tournaments in different statuses. Example: ?status=10&status=20

Response

The list of tournaments created by the user.

Changes

No recorded changes to this operation across all 16 revisions of this API.