Sign in

v3

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

Show one challenge

Get details about a challenge, even if it has been recently accepted, canceled or declined.

get/api/challenge/{challengeId}/show

Path parameters

challengeIdstring required

The challenge ID

Response

The challenge for that ID.

idstring required
urlstring uri required
status'created' | 'offline' | 'canceled' | 'declined' | 'accepted' required
ratedboolean required
speed'ultraBullet' | 'bullet' | 'blitz' | 'rapid' | 'classical' | 'correspondence' required
color'white' | 'black' | 'random' required
finalColor'white' | 'black'
direction'in' | 'out'
initialFenstring
rematchOfstring

Example response

{
  "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"
}