MngGetAINotificationsByFilter¶

GET ai/notifications

Texts the assistant generated from platform events: the ones waiting for approval, the ones delivered, and the ones that were stopped. The response also reports which delivery channels work right now.

Filter by state: "awaiting_approval" for the working screen; without a filter it is the journal.

Access Control¶

Allowed: admin. Records outside the administrator's brand are not returned.

Request¶

RESTTCPSDK

GET request

GET https://{broker_domain}/ai/notifications?state=awaiting_approval&limit=50
Authorization: <JWT_TOKEN>

{
  "command": "MngGetAINotificationsByFilter",
  "extID": "1",
  "data": { "state": "awaiting_approval", "limit": 50 }
}

const queue = await platform.MngGetAINotificationsByFilter({ state: 'awaiting_approval' });

Parameters¶

Parameter	Type	Description
`state`	enum	`pending`, `awaiting_approval`, `approved`, `sent`, `suppressed`, `failed`, `rejected`
`limit`	int	Default 50, maximum 500
`offset`	int	Rows to skip
`orderBy`	array	Default `["createdAt", "DESC"]`

Response Data¶

{
  "rows": [
    {
      "id": "ntf_7c1…",
      "brand": "Ion",
      "bindingId": 3,
      "runId": "run_2b8…",
      "eventName": "account.margin_state",
      "eventId": "a89e743cf46a4855986aa6769e47a075",
      "recipientType": "account",
      "recipientId": 2000067,
      "state": "awaiting_approval",
      "suppressReason": null,
      "content": "The margin level on your account is low…",
      "variables": { "login": 2000067, "margin_level": 95.4 },
      "delivery": null,
      "approvedBy": null,
      "approvedAt": null,
      "sentAt": null,
      "createdAt": "2026-09-17 10:12:04"
    }
  ],
  "count": 1,
  "channels": [
    { "channel": "notify", "implemented": true, "requires": "MngAddNotify", "available": true },
    { "channel": "email", "implemented": false, "requires": null, "available": false },
    { "channel": "sms", "implemented": false, "requires": null, "available": false }
  ]
}

recipientType is account, customer or manager. variables is the event payload the text was built from — useful when a manager needs to check a figure before approving.

Suppressed events are not stored: a high-volume event would otherwise fill the table with "not sent" rows. Why a particular event produced nothing is answered by MngTestAIWorkflowBinding.

Errors¶

Code	Error	Description
`403`	`AI_ACCESS_DENIED`	The session is not an administrator