---
title: "Get user activity"
method: GET
path: "/api/user/{username}/activity"
tags: ["Users"]
---

# Get user activity

`GET /api/user/{username}/activity`

Read data to generate the activity feed of a user.

## Path parameters

- `username` string, required

## Response `200`

The activity feed of the user.

- UserActivity[]
  - `interval` object, required
    - `start` integer, required
    - `end` integer, required
  - `games` object
    - `chess960` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `atomic` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `racingKings` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `ultraBullet` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `blitz` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `kingOfTheHill` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `bullet` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `correspondence` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `horde` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `puzzle` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `classical` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
    - `rapid` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
  - `puzzles` object
    - `score` UserActivityScore
      - `win` integer, required
      - `loss` integer, required
      - `draw` integer, required
      - `rp` object, required
        - `before` integer, required
        - `after` integer, required
  - `storm` PuzzleModePerf
    - `runs` integer, required
    - `score` integer, required
  - `racer` PuzzleModePerf
    - `runs` integer, required
    - `score` integer, required
  - `streak` PuzzleModePerf
    - `runs` integer, required
    - `score` integer, required
  - `tournaments` object
    - `nb` integer
    - `best` object[]
      - `tournament` object, required
        - `id` string, required
        - `name` string, required
      - `nbGames` integer, required
      - `score` integer, required
      - `rank` integer, required
      - `rankPercent` integer, required
  - `practice` object[]
    - `url` string, required
    - `name` string, required
    - `nbPositions` integer, required
  - `simuls` string[]
  - `correspondenceMoves` object
    - `nb` integer, required
    - `games` UserActivityCorrespondenceGame[], required
      - `id` string, required
      - `color` 'white' | 'black', required
      - `url` string, uri, required
      - `variant` 'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'
      - `speed` 'correspondence'
      - `perf` 'correspondence'
      - `rated` boolean
      - `opponent` union, required
        - object
          - `aiLevel` integer, required
        - object
          - `user` string, required
          - `rating` integer, required
  - `correspondenceEnds` object
    - `correspondence` object, required
      - `score` UserActivityScore, required
        - `win` integer, required
        - `loss` integer, required
        - `draw` integer, required
        - `rp` object, required
          - `before` integer, required
          - `after` integer, required
      - `games` UserActivityCorrespondenceGame[], required
        - `id` string, required
        - `color` 'white' | 'black', required
        - `url` string, uri, required
        - `variant` 'standard' | 'chess960' | 'crazyhouse' | 'antichess' | 'atomic' | 'horde' | 'kingOfTheHill' | 'racingKings' | 'threeCheck' | 'fromPosition'
        - `speed` 'correspondence'
        - `perf` 'correspondence'
        - `rated` boolean
        - `opponent` union, required
          - object
            - `aiLevel` integer, required
          - object
            - `user` string, required
            - `rating` integer, required
  - `follows` object
    - `in` UserActivityFollowList
      - `ids` string[], required
      - `nb` integer
    - `out` UserActivityFollowList
      - `ids` string[], required
      - `nb` integer
  - `studies` object[]
    - `id` string, required
    - `name` string, required
  - `teams` object[]
    - `url` string, uri, required
    - `name` string, required
    - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
  - `posts` object[]
    - `topicUrl` string, required
    - `topicName` string, required
    - `posts` object[], required
      - `url` string, required
      - `text` string, required
  - `patron` object
    - `months` integer, required
  - `stream` boolean

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)
