Retrieve notification

cURL

curl https://api.bodhveda.com/notifications/42069 \
  -H "Authorization: Bearer bv_xxxxxxxxx"

import { Bodhveda } from "@bodhveda/js";

const bodhveda = new Bodhveda("bv_xxxxxxxxx");

const notification = await bodhveda.notifications.get(42069);

// notification.status      -> "delivered" | "muted" | "quota_exceeded" | ...
// notification.email?.status -> "sent" | "delivered" | "bounced" | ...

import (
    "context"

    bodhveda "github.com/MudgalLabs/bodhveda/sdk/go"
)

ctx := context.Background()
client := bodhveda.NewClient("bv_xxxxxxxxx", nil)

notification, _ := client.Notifications.Get(ctx, 42069)

// notification.Status -> "delivered" | "muted" | ...
// notification.Email  -> nil unless the send included an email block

{
  "data": {
    "id": 42069,
    "recipient_id": "recipient_123",
    "payload": {
      "title": "Elon, Zuck and others commented on your post."
    },
    "broadcast_id": null,
    "target": {
      "channel": "posts",
      "topic": "post_id_123",
      "event": "new_comment"
    },
    "read": false,
    "opened": false,
    "status": "delivered",
    "completed_at": "2025-11-07T05:31:57Z",
    "created_at": "2025-11-07T05:31:56Z",
    "updated_at": "2025-11-07T05:31:57Z"
  }
}

GET

notifications

{notification_id}

cURL

curl https://api.bodhveda.com/notifications/42069 \
  -H "Authorization: Bearer bv_xxxxxxxxx"

import { Bodhveda } from "@bodhveda/js";

const bodhveda = new Bodhveda("bv_xxxxxxxxx");

const notification = await bodhveda.notifications.get(42069);

// notification.status      -> "delivered" | "muted" | "quota_exceeded" | ...
// notification.email?.status -> "sent" | "delivered" | "bounced" | ...

import (
    "context"

    bodhveda "github.com/MudgalLabs/bodhveda/sdk/go"
)

ctx := context.Background()
client := bodhveda.NewClient("bv_xxxxxxxxx", nil)

notification, _ := client.Notifications.Get(ctx, 42069)

// notification.Status -> "delivered" | "muted" | ...
// notification.Email  -> nil unless the send included an email block

{
  "data": {
    "id": 42069,
    "recipient_id": "recipient_123",
    "payload": {
      "title": "Elon, Zuck and others commented on your post."
    },
    "broadcast_id": null,
    "target": {
      "channel": "posts",
      "topic": "post_id_123",
      "event": "new_comment"
    },
    "read": false,
    "opened": false,
    "status": "delivered",
    "completed_at": "2025-11-07T05:31:57Z",
    "created_at": "2025-11-07T05:31:56Z",
    "updated_at": "2025-11-07T05:31:57Z"
  }
}

Retrieve a single notification by the id returned from send a notification. Because sending is asynchronous, this is how you learn what actually happened to a send:

status — the in-app outcome. enqueued right after the send, then delivered, muted (preferences disallow), quota_exceeded, or failed.
email — the email outcome, present only when the send included an email block. It has its own lifecycle: pending → sent (provider accepted) → delivered / bounced / complained (from provider webhooks), or failed / muted / no_contact.

Poll this endpoint after a send to confirm email delivery. email.delivered_at is set once the provider confirms delivery; email.bounced_at / email.complained_at flag problems.

Authorizations

Authorization

string

header

required

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

Path Parameters

notification_id

integer

required

The unique identifier of the notification (the id returned by the send endpoint).

Response

Notification found

Send notification Create recipient

API Reference

Notifications

Recipients

Project Preferences

Retrieve notification

Authorizations

Path Parameters

Response