Notifications

List the account's notifications

Returns the account's notification cards, cursor-paginated, plus unread_count and a latest_published_at watermark for cheap polling. Each post-related card carries the activity id for the Posts group. Page until cursor is null.

get/v1/{account_id}/notifications

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/notifications
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose notifications to read or act on.

Query parameters

filter'all' | 'jobs' | 'mentions' | 'my_posts' | 'my_posts_comments' | 'my_posts_reactions' | 'my_posts_reposts'

Which notification stream to read (default all): jobs, mentions, my_posts, my_posts_comments/reactions/reposts. Any other value is a 400.

limitinteger

Minimum notifications per page (1-100, default 20); the server returns whole pages up to this boundary. Page until cursor is null.

cursorstring

Opaque cursor from a prior response's cursor; omit for the first page, pass back verbatim. Poll unread_count instead of deep-paging.

Response

A page of the account's notification cards, plus the account-level unread badge (unread_count) and newest-notification watermark (latest_published_at). Injected/promo cards are included and flagged (injected:true). Zero notifications is a valid 200 (items:[], cursor:null, unread_count:0). Page until cursor is null.

object'notification_list' required

Response type discriminator.

cursorstring nullable required

Opaque cursor for the next page; null on the terminal page. Pass it back verbatim. There is no total (a shifting feed), page until cursor is null.

unread_countinteger required

The unseen-badge count for the account (0 when nothing is unread). Threaded from account metadata, NOT a count of items. Poll this cheaply rather than deep-paging.

latest_published_atnumber nullable required

Timestamp (epoch ms) of the newest notification, a poll watermark to detect 'anything new since last poll'. null if unavailable.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.