Returns the calling user's notifications (their Pivot Inbox), newest first, with who triggered each one, where it happened, the quoted text and a link to open it. By default it returns the Inbox: unread (NOTIFICATION_STATUS_RECEIVED) and read (NOTIFICATION_STATUS_OPEN) notifications. Pass statuses for unread only, snoozed or archived ones, types to narrow by kind (mentions are NOTIFICATION_TYPE_MENTIONED_MESSAGE, NOTIFICATION_TYPE_MENTIONED_YOU and NOTIFICATION_TYPE_BLOCK_CONTENT_MENTION), createdAfter/createdBefore for a time window, and query to match the quoted text. Each call reads at most 1,000 notifications, so a filtered page can hold fewer than limit items, even none, while hasMore is true: keep passing nextCursor as cursor until hasMore is false. Requires a user API key.
Opaque cursor from a previous response's nextCursor. Omit for the newest notifications.
Maximum number of notifications to return. Default 50, maximum 100; larger values are reduced to 100.
Statuses to return: NOTIFICATION_STATUS_RECEIVED (unread), NOTIFICATION_STATUS_OPEN (read), NOTIFICATION_STATUS_SNOOZED or NOTIFICATION_STATUS_ARCHIVED. Omit for the Inbox: unread and read.
Notification types to return (any type but NOTIFICATION_TYPE_UNSPECIFIED). Omit for every type.
Only notifications created after this time.
Only notifications created before this time.
Only notifications whose quoted text contains this, ignoring case.
Was this guide helpful?