v3

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

List your challenges

Get a list of challenges created by or targeted at you.

get/api/challenge

Response

The list of challenges created by or targeted at the logged in user.

Example response

{
  "in": [
    {
      "id": "H9fIRZUk",
      "url": "https://lichess.org/H9fIRZUk",
      "status": "created",
      "challenger": {
        "id": "bot1",
        "name": "Bot1",
        "rating": 1500,
        "title": "BOT",
        "provisional": true,
        "online": true,
        "lag": 4
      },
      "destUser": {
        "id": "bobby",
        "name": "Bobby",
        "rating": 1635,
        "title": "GM",
        "provisional": true,
        "online": true,
        "lag": 4
      },
      "variant": {
        "key": "standard",
        "name": "Standard",
        "short": "Std"
      },
      "rated": true,
      "speed": "rapid",
      "timeControl": {
        "type": "clock",
        "limit": 600,
        "increment": 0,
        "show": "10+0"
      },
      "color": "random",
      "finalColor": "black",
      "perf": {
        "icon": "",
        "name": "Rapid"
      },
      "direction": "out"
    }
  ],
  "out": [
    {
      "id": "H9fIRZUk",
      "url": "https://lichess.org/H9fIRZUk",
      "status": "created",
      "challenger": {
        "id": "bot1",
        "name": "Bot1",
        "rating": 1500,
        "title": "BOT",
        "provisional": true,
        "online": true,
        "lag": 4
      },
      "destUser": {
        "id": "bobby",
        "name": "Bobby",
        "rating": 1635,
        "title": "GM",
        "provisional": true,
        "online": true,
        "lag": 4
      },
      "variant": {
        "key": "standard",
        "name": "Standard",
        "short": "Std"
      },
      "rated": true,
      "speed": "rapid",
      "timeControl": {
        "type": "clock",
        "limit": 600,
        "increment": 0,
        "show": "10+0"
      },
      "color": "random",
      "finalColor": "black",
      "perf": {
        "icon": "",
        "name": "Rapid"
      },
      "direction": "out"
    }
  ]
}