v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Tournaments (Arena)

Create a new Arena tournament

Create a public or private Arena tournament. This endpoint mirrors the form on https://lichess.org/tournament/new. You can create up to 12 public tournaments per day, or 24 private tournaments. A team battle can be created by specifying the teamBattleByTeam argument. Additional restrictions:

  • clockTime + clockIncrement > 0
  • 15s and 0+1 variant tournaments cannot be rated
  • Clock time in comparison to tournament length must be reasonable: 3 <= (minutes * 60) / (96 * clockTime + 48 * clockIncrement + 15) <= 150
post/api/tournament

Response

The Arena tournament has been successfully created.

idstring required
fullNamestring required
ratedboolean
berserkableboolean
onlyTitledboolean
minutesinteger
createdBystring
systemstring
secondsToStartinteger
secondsToFinishinteger
isFinishedboolean
isRecentlyFinishedboolean
pairingsClosedboolean
startsAtstring int64
nbPlayersinteger required
allowListstring[]

List of usernames allowed to join the tournament

hasMaxRatingboolean
botsAllowedboolean
minAccountAgeInDaysinteger
descriptionstring
variantstring
myUsernamestring

Example response

{
  "maxRating": {
    "rating": 1700
  },
  "minRating": {
    "rating": 1700
  }
}