List team join requests
List pending requests to join a team you lead, with each applicant's message and profile.
GET https://cotlet.dev/api/v1/lichess/team-join-requests
read
Returns each request with the applicant username, the message they wrote, their ratings and account age. Only a leader of the team can read the requests. It reads only and does not change the queue.
Parameters
| Name | Type | Description |
|---|---|---|
| team_id string required | string | Team ID from list_user_teams, e.g. 'coders' for lichess.org/team/coders. |
| declined boolean | boolean | Return the declined requests instead of the pending ones. Default false. |
Request
curl "https://cotlet.dev/api/v1/lichess/team-join-requests?team_id=coders" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("lichess", "list_team_join_requests", {"team_id":"coders"})const result = await cotlet.call('lichess', 'list_team_join_requests', {"team_id":"coders"});cotlet call lichess list_team_join_requests --data '{"team_id":"coders"}'Example response
{
"requests": [
{
"username": "maya_plays",
"message": "Hi, I live in Riverside and play in the Tuesday school club.",
"rating_blitz": 1432,
"account_created": "2024-08-02"
},
{
"username": "bonus_link_77",
"message": "Visit my site for free chess lessons",
"rating_blitz": 1500,
"account_created": "2026-10-16"
}
],
"total": 2
}