Social API reference

Social API · Notifications

get/v1/communities/{community_id}/actors/{actor_id}/notifications/unread-countAuth

Count unread notifications for an actor.

Cheap badge endpoint backed by a partial index — safe to poll at the cadence of an in-product notification bell.

Path parameters

community_id*string

Community UUID.

actor_id*string

Social actor UUID (returned from POST /actors).

Response · 200 Count of unread rows.

count*number

Number of unread notifications for the actor.

Example: 7

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/notifications/unread-count
Authorization: Bearer YOUR_TOKEN

Response

{
  "count": 7
}