List an anime or manga list

Read a user's list, optionally filtered by status.

GET https://cotlet.dev/api/v1/anilist/media-lists

read

Returns entries with media ID, title, status, progress, score and the date of the last update. Your own private entries are included only for the signed-in account. Long lists come back in pages.

Parameters

Parameters: list_media_list
NameTypeDescription
type string required string ANIME or MANGA.
username string string AniList username. Defaults to the signed-in account.
status string string CURRENT, PLANNING, COMPLETED, DROPPED, PAUSED or REPEATING. Leave out for all.
cursor string string Next page cursor from the previous call.

Request

cURL
curl "https://cotlet.dev/api/v1/anilist/media-lists?type=type" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("anilist", "list_media_list", {"type":"type"})
Node.js
const result = await cotlet.call('anilist', 'list_media_list', {"type":"type"});
CLI
cotlet call anilist list_media_list --data '{"type":"type"}'

Example response

JSON

{
  "items": [
    {
      "media_id": 154587,
      "title": "Frieren: Beyond Journey's End",
      "status": "CURRENT",
      "progress": 24,
      "score": null,
      "updated_at": "2026-10-15"
    },
    {
      "media_id": 166873,
      "title": "Dungeon Meshi",
      "status": "CURRENT",
      "progress": 22,
      "score": null,
      "updated_at": "2026-10-12"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.