Replay committed notifications events at-or-after since

GET /events

Replay committed notifications events at-or-after since (a journal sequence number), oldest first: the sender saved, the sending domain added, verified, failed and removed, the SMS sender ID saved, moved in a country and removed, every notification requested, sent and failed and what the provider reported of it — delivered, delayed, bounced, marked as spam, opened, clicked (a customer opening the page its message linked to among them), opted out — every address suppressed and lifted, tracking switched, every email template saved, archived and activated, the email style chosen, the brand saved and its logo saved and removed, the customer pages' own host requested, verified, gone live, lapsed and removed, every push device registered and removed, push preferences saved, every push raised, alert preferences saved and every sync problem noted for the daily digest.

One response is a page: limit defaults to 500 and is capped at 5000 (an over-cap request is clamped). Pages are sequence-ordered and the boundary is stable — repeat with since=<last event's sequence + 1> until a page comes back smaller than limit to replay the journal exactly once. upTo (inclusive) ends the replay at a sequence instead of the journal's head — with GET /events/head it replays the journal as it stood at a moment. Appends nothing: a read of facts already journalled.

Access

Requires notifications:read or activity:read.

Any one of these scopes is enough.

How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.

AI agent tool

No agent tool. The journal replay a consumer pages through to build its projection; agents read the projections the list and get tools serve, and the audit trail (audit_trail) for history.

Connecting an agent: AI agents.

Example

curl

curl -X GET 'https://notifications.getmanifold.io/events?since=41&limit=500' \
  -H "Authorization: Bearer $MANIFOLD_TOKEN"

JavaScript (fetch)

const response = await fetch("https://notifications.getmanifold.io/events?since=41&limit=500", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();

Response · 200 · application/json

[
  {
    "_tag": "notifications.requested",
    "eventId": "evt_01a1581c-208c-763f-a253-ebed1feb2268",
    "txId": "tx_01a15853-0f8e-757f-9a34-afad80e0abf5",
    "tenantId": "org_01a156d2-8680-7738-ab2e-ff985e454887",
    "sequence": 41,
    "occurredAt": "2026-10-20T05:40:11.000Z",
    "source": "notifications-manager",
    "version": 1,
    "actor": {
      "_tag": "user",
      "id": "usr_01a15709-7582-7646-b491-261a138f0650"
    },
    "correlationId": "req_01a157e5-318a-7e8f-92b2-a2a1bd882b0f",
    "payload": {
      "notificationId": "ntf_01a157ae-4288-7f3b-bb14-41f2affd24eb",
      "kind": "sending-test",
      "channel": "email",
      "to": [
        "ops@ridgeline-outdoor.example"
      ],
      "cc": [],
      "from": "\"Ridgeline Outdoor\" <accounts@ridgeline-outdoor.example>",
      "replyTo": "accounts@ridgeline-outdoor.example",
      "subject": "Test message from Ridgeline Outdoor",
      "source": {
        "kind": "settings",
        "id": "sender"
      }
    }
  },
  {
    "_tag": "notifications.sent",
    "eventId": "evt_01a15889-fe90-7c50-8c80-064cc824f438",
    "txId": "tx_01a158c0-ed92-7a97-baae-49c3a7e8454e",
    "tenantId": "org_01a156d2-8680-7738-ab2e-ff985e454887",
    "sequence": 42,
    "occurredAt": "2026-10-20T05:40:12.000Z",
    "source": "notifications-manager",
    "version": 1,
    "actor": {
      "_tag": "system",
      "id": "notifications-manager:send"
    },
    "correlationId": "req_01a157e5-318a-7e8f-92b2-a2a1bd882b0f",
    "causationId": "evt_01a1581c-208c-763f-a253-ebed1feb2268",
    "payload": {
      "notificationId": "ntf_01a157ae-4288-7f3b-bb14-41f2affd24eb",
      "providerMessageId": "0108019a2b3c4d5e-01a1587e-cd9b-7f2a-9b3c-4d5e6f7a8b9c-000000"
    }
  }
]

The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: notifications-manager.openapi.json. Base URL https://notifications.getmanifold.io.

Errors

Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.

`401`

Refusal	What it means	What to do
`Unauthorized` reason	The token is missing, expired or not one Manifold issued.	Get a fresh token and send the call again.
`TokenAlreadyUsed` tokenId	A single-use app token was already spent.	Mint a new token for this call.

`402`

Refusal	What it means	What to do
`SubscriptionRequired` status	The organization's subscription has lapsed, so writes are refused.	An owner settles billing. Reads still work meanwhile.

`403`

Refusal	What it means	What to do
`TenantRequired` userId	The token names no organization.	Choose the organization, then get a new token.
`ScopeRequired` required	The token's roles do not grant the scope this call needs.	Ask an owner or admin for a role that grants it.

`409`

Refusal	What it means	What to do
`MirroredFromSource` source	This area is fed by your source system until the organization goes live.	Make the change in the source system, or go live first.

`503`

Refusal	What it means	What to do
`RequestLogUnavailable` tokenId, reason	The service could not record the request, so it did nothing.	Try again shortly.

How refusals work everywhere: Errors.