API ReferenceNotifications

List notifications

GET /rest/v1/notifications

GET
/notifications

The store owner’s notification center, newest first. Requires events:read.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Query Parameters

lane?string

updates or alerts

Response Body

application/json

application/json

curl -X GET "https://example.com/notifications"
{  "object": "list",  "data": [    {      "object": "notification",      "id": "ntf_6ad297e47ed3d98340e4b022",      "kind": "string",      "lane": "updates",      "title": "string",      "body": "string",      "link": "string",      "read": true,      "created_at": "2019-08-24T14:15:22Z"    }  ],  "unread": 0}

Last updated on October 8, 2026

Need help?

Email us and a human replies, usually within one business day.