MyAnimeList User Anime List API

Q: Why is `score` a number but `status` a code?

`score` is the member's score, or null. `status` is the numeric list status and `statusLabel` is its name, so you can use either without a mapping table.

Q: Does the list include private notes?

`notes` carries the member's own note on the entry, as plain text. Private list settings are not bypassed. An unknown member and a list its owner has hidden both return `not_found`.

A public anime list with scores, progress, tags and dates, 300 entries per page.

GET /v1/myanimelist/users/{username}/anime-list

1 credit Failed requests are free A not-found answer is still charged

Try in playground Full API docs

About this endpoint

GET /v1/myanimelist/users/{username}/anime-list returns data.username, data.entries[] and page. Each entry has id, title, titleEnglish, status, statusLabel, createdAt, updatedAt, score, tags, isRewatching, watchedEpisodes, totalEpisodes, airingStatus, studios, licensors, season, totalMembers, totalScores, scoreValue, scoreDiff, popularity, hasEpisodeVideo, hasPromotionVideo, hasVideo, videoUrl, genres, demographics, url, imageUrl, mediaType, rating, startDate, finishDate, airedFrom, airedTo, days and notes.

Filter with status: 1 watching, 2 completed, 3 on hold, 4 dropped, 6 planned, 7 all (the default). Each page holds 300 entries and page.nextCursor continues. A missing profile and a list its owner has hidden both return lookupStatus: not_found, not an empty list.

MyAnimeList User Anime List API FAQ

What do the status codes mean?

1 is watching, 2 is completed, 3 is on hold, 4 is dropped, 6 is planned and 7 is all. The route accepts those six values and defaults to 7.

Why is `score` a number but `status` a code?

score is the member's score, or null. status is the numeric list status and statusLabel is its name, so you can use either without a mapping table.

How many credits does this request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Does the list include private notes?

notes carries the member's own note on the entry, as plain text. Private list settings are not bypassed. An unknown member and a list its owner has hidden both return not_found.

About this endpoint

MyAnimeList User Anime List API FAQ

Other MyAnimeList endpoints