Get User Activity

Get user activity feed

This endpoint reads the most recent activities of a user, including games played, puzzles solved, tournaments joined, and more.

Activity data is collected in daily intervals and may not reflect real-time activity.

Endpoint

GET https://lichess.org/api/user/{username}/activity

Path Parameters

username

string

required

The username of the user whose activity to fetch

Example Request

curl "https://lichess.org/api/user/DrNykterstein/activity"

Response

Returns an array of activity objects, each representing activity in a specific time interval (typically 1-2 weeks).

interval

object

Time period for this activity

Show Interval

start

integer

Start timestamp in milliseconds

end

integer

End timestamp in milliseconds

games

object

Games played during this interval, grouped by performance type

Show Games by variant

Each key is a performance type (blitz, rapid, classical, etc.) with:

win

integer

Number of wins

loss

integer

Number of losses

draw

integer

Number of draws

object

Rating progress

Show Rating progress

before

integer

Rating before this period

after

integer

Rating after this period

puzzles

object

Puzzle training activity

Show Puzzle stats

score

object

Puzzle performance

Show Score

win

integer

Puzzles solved correctly

loss

integer

Puzzles failed

draw

integer

Puzzles solved with hints

object

Rating progress (before/after)

tournaments

object

Tournament participation

Show Tournament entries

integer

Number of tournaments joined

best

array

Best tournament results

Show Tournament entry

tournament

object

Tournament information

Show Tournament details

string

Tournament ID

name

string

Tournament name

nbGames

integer

Games played in the tournament

score

integer

Tournament score

rank

integer

Final rank in the tournament

rankPercent

integer

Rank as a percentage (0-100)

practice

array

Practice positions completedEach entry contains:

url: Link to the practice study
name: Name of the practice study
nbPositions: Number of positions completed

simuls

array

Simul participation (simultaneous exhibitions)

Show Simul details

string

Simul ID

name

string

Simul name

isHost

boolean

Whether the user hosted the simul

variants

array

Chess variants played

correspondenceMoves

object

Moves made in correspondence games

Show Correspondence moves

integer

Number of moves made

games

array

Sample games with recent moves

correspondenceEnds

object

Correspondence games completed, grouped by variantEach variant contains:

score: Win/loss/draw counts
games: Sample completed games

follows

object

Following activity

Show Follow stats

object

Followers gained

Show Follower details

ids

array

User IDs of new followers

out

object

Users followed

Show Following details

ids

array

User IDs of newly followed users

studies

array

Studies created during this periodEach entry contains:

id: Study ID
name: Study name

teams

array

Teams joinedEach entry contains:

url: Team URL
name: Team name
flair: Team flair (optional)

posts

array

Forum posts made

Show Forum post

topicUrl

string

URL to the forum topic

topicName

string

Forum topic name

posts

array

Posts in the topic

Show Post details

url

string

Direct link to the post

text

string

Post text (truncated to 500 characters)

patron

object

Patron support activity

Show Patron details

months

integer

Number of months supported

stream

boolean

Whether the user streamed during this period

storm

object

Puzzle Storm activity

Show Storm stats

runs

integer

Number of runs

score

integer

Best score

racer

object

Puzzle Racer activity

Show Racer stats

runs

integer

Number of races

score

integer

Best score

streak

object

Puzzle Streak activity

Show Streak stats

runs

integer

Number of attempts

score

integer

Best streak

Example Response

[
  {
    "interval": {
      "start": 1708300800000,
      "end": 1708905600000
    },
    "games": {
      "blitz": {
        "win": 45,
        "loss": 32,
        "draw": 8,
        "rp": {
          "before": 2987,
          "after": 3003
        }
      },
      "rapid": {
        "win": 12,
        "loss": 7,
        "draw": 3,
        "rp": {
          "before": 2939,
          "after": 2927
        }
      }
    },
    "puzzles": {
      "score": {
        "win": 87,
        "loss": 13,
        "rp": {
          "before": 2845,
          "after": 2891
        }
      }
    },
    "tournaments": {
      "nb": 3,
      "best": [
        {
          "tournament": {
            "id": "abc123",
            "name": "Titled Arena Feb '24"
          },
          "nbGames": 23,
          "score": 67,
          "rank": 1,
          "rankPercent": 1
        }
      ]
    },
    "correspondenceMoves": {
      "nb": 45,
      "games": [
        {
          "id": "xyz789",
          "color": "white",
          "url": "https://lichess.org/xyz789/white",
          "opponent": {
            "user": "opponent123",
            "rating": 2400
          }
        }
      ]
    },
    "follows": {
      "in": {
        "ids": ["user1", "user2", "user3"]
      },
      "out": {
        "ids": ["user4", "user5"]
      }
    },
    "storm": {
      "runs": 12,
      "score": 89
    }
  }
]

Notes

Activity is aggregated in time intervals, typically covering 1-2 weeks
The most recent activities are returned first
Empty activity periods may be omitted from the response
Some fields are only present if there was activity in that category

Getting Started

Games

Users

Tournaments

Studies

Puzzles

Broadcasts

TV & Streaming

Bot API

Get User Activity