List studies of a user
List the studies of a user with their IDs, names and update dates.
GET https://cotlet.dev/api/v1/lichess/studies
read
Returns each study's ID, name, creation date and last update, most recent first. For the signed-in account it includes private and unlisted studies; for another user only public ones. It reads only.
Parameters
| Name | Type | Description |
|---|---|---|
| username string | string | Lichess username. Defaults to the signed-in account, which also returns private and unlisted studies. |
Request
curl https://cotlet.dev/api/v1/lichess/studies \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("lichess", "list_studies")const result = await cotlet.call('lichess', 'list_studies');cotlet call lichess list_studiesExample response
{
"studies": [
{
"study_id": "Wk3bPzQa",
"name": "Club Games 2026",
"created_at": "2026-01-09T18:00:00Z",
"updated_at": "2026-10-11T20:41:00Z"
},
{
"study_id": "Hn8eLr2c",
"name": "Opening Repertoire: London System",
"created_at": "2025-11-22T09:15:00Z",
"updated_at": "2026-09-02T07:30:00Z"
}
]
}