v3

OpenAPI 3.1.0AGPL-3.0-or-later2026-07-311871891.1 MB
Simuls

Get current simuls

Get recently created, started, finished, simuls. Created and finished simul lists are not exhaustives, only those with strong enough host will be listed, the same filter is used to display simuls on https://lichess.org/simul. When authenticated with OAuth2, the pending list will be populated with your created, but unstarted simuls.

get/api/simul

Response

The list of simuls.

Example response

{
  "pending": [
    {
      "variants": [
        {
          "key": "standard"
        }
      ]
    }
  ],
  "created": [
    {
      "variants": [
        {
          "key": "standard"
        }
      ]
    }
  ],
  "started": [
    {
      "variants": [
        {
          "key": "standard"
        }
      ]
    }
  ],
  "finished": [
    {
      "variants": [
        {
          "key": "standard"
        }
      ]
    }
  ]
}