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

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).

object

Time period for this activity

Show Interval

integer

Start timestamp in milliseconds

integer

End timestamp in milliseconds

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:

integer

Number of wins

integer

Number of losses

integer

Number of draws

object

Rating progress

Show Rating progress

integer

Rating before this period

integer

Rating after this period

object

Puzzle training activity

Show Puzzle stats

object

Puzzle performance

Show Score

integer

Puzzles solved correctly

integer

Puzzles failed

integer

Puzzles solved with hints

object

Rating progress (before/after)

object

Tournament participation

Show Tournament entries

integer

Number of tournaments joined

array

Best tournament results

Show Tournament entry

object

Tournament information

Show Tournament details

string

Tournament ID

string

Tournament name

integer

Games played in the tournament

integer

Tournament score

integer

Final rank in the tournament

integer

Rank as a percentage (0-100)

array

Practice positions completedEach entry contains:

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

array

Simul participation (simultaneous exhibitions)

Show Simul details

string

Simul ID

string

Simul name

boolean

Whether the user hosted the simul

array

Chess variants played

object

Moves made in correspondence games

Show Correspondence moves

integer

Number of moves made

array

Sample games with recent moves

object

Correspondence games completed, grouped by variantEach variant contains:

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

object

Following activity

Show Follow stats

object

Followers gained

Show Follower details

array

User IDs of new followers

object

Users followed

Show Following details

array

User IDs of newly followed users

array

Studies created during this periodEach entry contains:

id: Study ID
name: Study name

array

Teams joinedEach entry contains:

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

array

Forum posts made

Show Forum post

string

URL to the forum topic

string

Forum topic name

array

Posts in the topic

Show Post details

string

Direct link to the post

string

Post text (truncated to 500 characters)

object

Patron support activity

Show Patron details

integer

Number of months supported

boolean

Whether the user streamed during this period

object

Puzzle Storm activity

Show Storm stats

integer

Number of runs

integer

Best score

object

Puzzle Racer activity

Show Racer stats

integer

Number of races

integer

Best score

object

Puzzle Streak activity

Show Streak stats

integer

Number of attempts

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