Skip to main content
GET
/
recipients
/
{recipient_id}
/
notifications
{
  "data": {
    "notifications": [
      {
        "id": 42069,
        "recipient_id": "recipient_123",
        "payload": {
          "title": "Elon, Zuck and others commented on your post.",
          "post_url": "/posts/post_id_123#comments"
        },
        "broadcast_id": null,
        "target": {
          "channel": "posts",
          "topic": "post_id_123",
          "event": "new_comment"
        },
        "read": false,
        "opened": false,
        "created_at": "2025-11-07T05:31:56Z",
        "updated_at": "2025-11-07T05:31:56Z"
      }
    ],
    "cursor": {
      "before": "42069",
      "after": "42069"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer bv_xxxxxxxxx, where bv_xxxxxxxxx is your API Key with Full access or Recipient acess scope.

Path Parameters

​
recipient_id
string
required

The unique identifier of the recipient.

Query Parameters

​
before
string

Returns results before the specified cursor. Use this to paginate backwards or fetch earlier items in the list.

​
after
string

Returns results after the specified cursor. Use this to paginate forwards or fetch newer items in the list.

​
limit
integer
default:10

Maximum number of notifications to return.

Required range: x <= 100

Response

200 - application/json

List of notifications for the recipient.

The response is of type any.

⌘I