Skip to main content

Get unseen and unread inbox counts

POST 

/api/v1/notifications/get-inbox-unseen-count

Returns the number of unseen and unread messages in the user's inbox, optionally filtered by feed IDs.

Counts are capped. Inspect the overflow flags before treating them as exact totals.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build an in-app inbox

Request​

Responses​

Counts retrieved successfully

Count unseen messages in the selected user’s inbox.​

Section ID: DOC-CP-notifications-api-getInboxUnseenCount#example-notifications-getInboxUnseenCount-request

Request example

{}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-CP-notifications-api-getInboxUnseenCount#example-notifications-getInboxUnseenCount-response

Response example

{
"unseenCount": 1,
"unreadCount": 1,
"hasMoreUnseen": true,
"hasMoreUnread": true
}

Document ID: DOC-CP-notifications-api-getInboxUnseenCount. Section identities and revisions.

SectionStable reference
Get unseen and unread inbox countsDOC-CP-notifications-api-getInboxUnseenCount#overview
RequestDOC-CP-notifications-api-getInboxUnseenCount#request
ResponsesDOC-CP-notifications-api-getInboxUnseenCount#responses