---
title: "Get join requests"
method: GET
path: "/api/team/{teamId}/requests"
tags: ["Teams"]
---

# Get join requests

`GET /api/team/{teamId}/requests`

Get pending join requests of your team

## Path parameters

- `teamId` string, required

## Query parameters

- `declined` boolean

## Response `200`

The list of pending join requests on your team

- TeamRequestWithUser[]
  - `request` TeamRequest, required
    - `teamId` string, required
    - `userId` string, required
    - `date` integer, required
    - `message` string
  - `user` User, required
    - `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/versions/1425db81eb3b/schema)