Skip to content

NotificationPage

A page of notifications, newest first.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

A notification of something that happened to the authenticated user.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
type
required

The kind of a notification. account is the account that acted: the follower (follow, follow_request), the followed account (follow_accepted), the author (mention), the booster (boost), the account that favourited (favourite), or the account that reacted with an emoji (reaction, whose reaction is the emoji; a reaction with another emoji is another notification), or the account that quoted a post of the user (quote, once the quote is approved or, from software without approvals, received). status is the post that mention, boost, favourite, reaction, and poll_closed are about, and for quote the post that quotes. reply_request, boost_request, and quote_request tell that account replied to, boosted, or quoted the user’s status and that it waits for the user’s approval (listInteractionRequests); interaction_accepted and interaction_rejected tell that account, the author of status, approved or refused the user’s reply to it, boost of it, or quote of it. moderation_notice comes from the instance and has no account; its moderation_action is the action on the user’s account, with its kind, reason, and end. report_resolved also comes from the instance: its report is the user’s report that the moderators resolved, without how they resolved it. It is sent once per report, even when the report is reopened and resolved again. appeal_decided also comes from the instance: the moderators decided the user’s appeal, and its moderation_action is the action with the appeal and the decision. hook_appeal_decided also comes from the instance: a moderator upheld or overturned the user’s appeal of a post that the automated review refused, and its hook_appeal is the appeal with its state; first-party clients only, as the appeal is. It is sent once per appeal. relationships_severed also comes from the instance: its relationship_severance tells how many follows the user lost when the moderators suspended a server or a remote account, whose account it carries for an account. It is sent once per suspension. The moderator notifications come from the instance too: admin_report (an account that had no open report was reported; report_id is the report) goes to the users with the manage_reports permission, admin_sign_up (a registration awaits approval; account is the new user’s account) to those with manage_accounts, and admin_appeal (a user appealed an action; appeal_id is the appeal) to those with manage_accounts, and admin_webhook_disabled (the server disabled a webhook that answered 410 Gone or kept failing; it names none) to those with manage_webhooks, and admin_hook_failing (calls of an external review keep failing; it names none) and admin_hook_appeal (a user appealed a post that the automated review refused; hook_appeal_id is the appeal) to those with manage_reports, and admin_custom_emoji_request (a user requested a custom emoji or a new image of one; custom_emoji_request is the request) to those with manage_custom_emojis, and admin_domain_list_failing (three fetches in a row of a subscribed domain block list failed; it names none) to those with manage_domains. custom_emoji_request_decided also comes from the instance: an administrator approved or rejected the user’s custom emoji request, which custom_emoji_request carries with its state and the reason of a rejection. The supporter notifications also come from the instance and tell of the user’s own supporter subscription, which supporter_subscription carries as it is now: supporter_payment_failed (a payment failed; the plan’s role stays until grace_ends_at unless a payment succeeds), supporter_subscription_ended (the subscription lost the plan’s role; end_reason says why), and supporter_plan_retired (the administrators retired the plan; the subscription ends with its period). Each is sent once per change of the subscription. A client must not lead from them to subscribing or paying where it offers no way to subscribe. account_moved tells that an account that the user followed (account) moved to another one; its account_move carries the target and what became of the user’s follow. It is sent once per move. admin_account_moved goes to the users with manage_accounts: an account that the moderators limit moved, and the target does not get the limit; its account_move carries the target, and it has no account. service_closure goes to every local user when the closure of the service is announced, when its dates change, and when the announcement is withdrawn; admin_service_closure_due goes to the users with manage_service_closure once the closing date of the announcement in effect has passed, to close the server; supporter_service_closure tells a subscriber that the announcement cancels their supporter subscription at the end of its period, with its supporter_subscription. Their service_closure says what they tell of, and they have no account. voice_room_started tells that an account that the user follows (account, the host) opened a voice chat room that the user sees, once per room; voice_room_invited that the host or a co-host of a room (account) invited the user to it, once per invitation. Both carry voice_room_id, and voice_room while the room is open and the user sees it. admin_error_group tells the holders of manage_errors of a new error group or of a resolved one that happened again, at most 10 times an hour for the whole server, with the rest of the hour folded into one; its error_group says which, and it has no account. The type status tells of a new post (status) of an account that the user subscribes to (account, the author; subscribeAccount), once per post. It is not sent for a reply to someone else’s post, a boost, an edit, or a post that the server fetched rather than received, nor when the user gets a mention of the same post. announcement goes to every local user once a server-wide announcement starts to show (its publication, or the start of its window when that comes later), once per announcement; its announcement carries it, and it has no account. Editing the announcement afterwards sends nothing again, and the notification leaves the list and the unread count once the announcement is withdrawn or its window ends. auto_delete_limit comes from the instance: the server maximum of the automatic deletion of old posts now binds the user (it was turned on or lowered, or the user lost the permission keep_posts_longer), and after a grace period it deletes the user’s posts that their own policy keeps. Its auto_delete_limit carries the maximum and when it starts to apply, and it has no account. It is sent once per notice. scheduled_status_failed comes from the instance: a post that the user scheduled could not be published at its time, and its draft stays to fix and schedule again. Its scheduled_status_failure carries the draft, why, and when it was to be published, while the draft exists, and it has no account. It is sent once per schedule; a published scheduled post sends nothing. The event_* types tell of an event of the server (event_id, and event while the user sees it). event_invited tells that account invited the user, once per invitation; event_schedule_confirmed that the organizers fixed the date of an event whose date poll the user answered or to which the user was invited, once per date; event_changed that the date, the places, or the voice chat room of an event that the user answered going or maybe to, or was invited to, changed, once per change (a change of the title or the description sends nothing); event_cancelled that such an event was cancelled; event_reminder that an event that the user answered going or maybe to starts soon, at each time before the start that the user chose (getEventReminders), once per date and time, and never for a date that changed since; event_started that it starts now, once per date; event_room_unavailable tells the organizer that the voice chat room of the event cannot open; and event_board_posted tells a user who answered going or maybe that account wrote a new post (status) on the board of the event, once per post, but not when the post mentions the user, who gets the mention instead. Their account is the organizer, except for event_invited and event_board_posted. Each is sent only while the user sees the event, and an event_board_posted only while the user reads its board.

string
Allowed values: follow follow_request follow_accepted mention boost favourite reaction quote poll_closed moderation_notice report_resolved admin_report admin_sign_up relationships_severed appeal_decided admin_appeal admin_webhook_disabled admin_hook_failing admin_domain_list_failing admin_custom_emoji_request custom_emoji_request_decided supporter_payment_failed supporter_subscription_ended supporter_plan_retired account_moved admin_account_moved service_closure admin_service_closure_due supporter_service_closure voice_room_started voice_room_invited admin_error_group status announcement admin_hook_appeal hook_appeal_decided auto_delete_limit scheduled_status_failed event_invited event_schedule_confirmed event_changed event_cancelled event_reminder event_started event_room_unavailable event_board_posted reply_request boost_request quote_request interaction_accepted interaction_rejected
created_at
required

When it happened.

string format: date-time
read
required

Whether the user has read it: it is older than or at the marker’s last_read_id, or it was marked read on its own (POST /notifications/{id}/read).

boolean
account

Schema: Account

object
status

The post that the notification is about, as the user sees it; omitted when the user may not see it.

Schema: Status

object
report

The user’s report that a report_resolved tells of; omitted without read:reports.

Schema: Report

object
moderation_action

The action on the user’s account that a moderation_notice tells of, or whose appeal an appeal_decided tells of, with the appeal; first-party clients only.

Schema: ModerationAction

object
report_id

The report that an admin_report is about.

string format: uuid
appeal_id

The appeal that an admin_appeal is about.

string format: uuid
hook_appeal_id

The appeal of a refused post that an admin_hook_appeal is about.

string format: uuid
hook_appeal

The user’s appeal of a refused post that a hook_appeal_decided tells of, with its state; first-party clients only, and absent once the appeal is no longer kept.

Schema: OwnHookAppeal

object
custom_emoji_request

The custom emoji request that an admin_custom_emoji_request or a custom_emoji_request_decided is about, as it is now; absent when it no longer exists, and without read:custom_emojis.

Schema: CustomEmojiRequest

object
supporter_subscription

The user’s supporter subscription that a supporter_payment_failed, a supporter_subscription_ended, or a supporter_plan_retired is about, as it is now; absent when it no longer exists, and without read:supporters.

Schema: SupporterSubscription

object
relationship_severance

The follows that a relationships_severed tells of; omitted without read:follows.

Schema: RelationshipSeverance

object
account_move

Schema: AccountMove

object
service_closure
object
reaction

The emoji of a reaction; omitted for the other types.

Schema: ReactionEmoji

object
voice_room_id

The voice chat room that a voice_room_started or a voice_room_invited is about.

string format: uuid
voice_room

The voice chat room that a voice_room_started or a voice_room_invited is about, while it is open and the user sees it; omitted otherwise, and without read:voice.

Schema: VoiceRoom

object
event_id

The event that an event_* notification is about.

string format: uuid
event

The event that an event_* notification is about, as the user sees it now; omitted when the user no longer sees it, for the other types, and without read:events.

Schema: Event

object
error_group

What an admin_error_group tells of; omitted for the other types.

Schema: NotificationErrorGroup

object
announcement

The announcement that an announcement tells of, as the user sees it; omitted for the other types.

Schema: Announcement

object
auto_delete_limit

What an auto_delete_limit tells of; omitted for the other types.

Schema: NotificationAutoDeleteLimit

object
scheduled_status_failure

The scheduled post that a scheduled_status_failed tells of, while its draft exists; omitted otherwise and for the other types.

Schema: NotificationScheduledStatusFailure

object

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"type": "follow",
"created_at": "2026-04-15T12:00:00Z",
"read": true,
"account": {},
"status": {},
"report": {},
"moderation_action": {},
"report_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"appeal_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"hook_appeal_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"hook_appeal": {},
"custom_emoji_request": {},
"supporter_subscription": {},
"relationship_severance": {},
"account_move": {},
"service_closure": {},
"reaction": {},
"voice_room_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"voice_room": {},
"event_id": "01890a5d-ac96-774b-bcce-b302099a8057",
"event": {},
"error_group": {},
"announcement": {},
"auto_delete_limit": {},
"scheduled_status_failure": {}
}
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site