Get your AniList notifications
get_notificationsRetrieve the authenticated user's AniList notifications for new episodes, activity interactions, follows, and submission updates.
Instructions
[Requires login] Get the authenticated user's AniList notifications: new episodes airing, activity likes/replies/mentions, new followers, thread replies/likes, and media/staff/character data-submission updates. Every item has id, type and a human-readable context/contexts string; the rest of the fields depend on type (e.g. an AIRING item includes media/episode, a FOLLOWING item includes user, an ACTIVITY_MESSAGE item includes message.message — the actual DM text is nested one level inside message).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| perPage | No | Results per page (max 25). | |
| type_in | No | Restrict to these notification types. Omit to get every type. | |
| markAsRead | No | Set true to also reset AniList's unread-notification badge count to 0, as a side effect of this call (the same effect as opening the notifications page on the site). Defaults to false so a routine check doesn't clear the badge. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes |