---
title: "Get users by ID"
method: POST
path: "/api/users"
tags: ["Users"]
---

# Get users by ID

`POST /api/users`

Get up to 300 users by their IDs. Users are returned in the same order as the IDs.
The method is `POST` to allow a longer list of IDs to be sent in the request body.
Please do not try to download all the Lichess users with this endpoint, or any other endpoint.
An API is not a way to fully export a website. We do not provide a full download of the Lichess users.
This endpoint is limited to 8,000 users every 10 minutes, and 120,000 every day.

## Query parameters

- `profile` boolean
- `rank` boolean

## Response `200`

The list of users.

- User[]
  - `id` string, required
  - `username` string, required
  - `perfs` Perfs
    - `chess960` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `atomic` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `racingKings` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `ultraBullet` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `blitz` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `kingOfTheHill` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `threeCheck` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `antichess` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `crazyhouse` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `bullet` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `correspondence` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `horde` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `puzzle` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `classical` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `rapid` Perf
      - `games` integer, required
      - `rating` integer, required
      - `rd` integer, required — rating deviation
      - `prog` integer, required
      - `prov` boolean — only appears if a user's perf rating are [provisional](https://lichess.org/faq#provisional)
      - `rank` integer — global lichess ranking, only appears for recently active players
    - `storm` PuzzleModePerf
      - `runs` integer, required
      - `score` integer, required
    - `racer` PuzzleModePerf
      - `runs` integer, required
      - `score` integer, required
    - `streak` PuzzleModePerf
      - `runs` integer, required
      - `score` integer, required
  - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
  - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
  - `createdAt` integer
  - `disabled` boolean — only appears if a user's account is closed
  - `tosViolation` boolean — only appears if a user's account is marked for the violation of [Lichess TOS](https://lichess.org/terms-of-service)
  - `profile` Profile
    - `flag` string
    - `location` string
    - `bio` string
    - `realName` string
    - `fideRating` integer — only appears if a user has set them
    - `uscfRating` integer — only appears if a user has set them
    - `ecfRating` integer — only appears if a user has set them
    - `cfcRating` integer — only appears if a user has set them
    - `rcfRating` integer — only appears if a user has set them
    - `dsbRating` integer — only appears if a user has set them
    - `links` string
  - `seenAt` integer
  - `playTime` PlayTime
    - `total` integer, required
    - `tv` integer, required
    - `human` integer
  - `patron` boolean — Use patronColor value instead to determine if player is a patron.
  - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
  - `verified` 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/revisions/f16676f55a94/schema)