GET /api/v3/account/{accountId}/alert

Retrieves all alerts (notifications and notes) associated with a specific account

GetAccountAlertsV3 Permissions: Accounts (View)
Use this endpoint to get all alerts on an account. Alerts are user-created messages or system-generated notifications attached to an account — they serve as notes, warnings, or action items visible during bill entry and account management. To retrieve a single specific alert, use GET /account/{accountId}/alert/{alertId}. To create, update, or delete alerts, use the POST/PUT/DELETE alert endpoints.

Request Headers

Header Value Required Description
ECI-ApiKey string Yes Your API key. See Authentication.
Content-Type application/json Yes All requests must specify JSON content type.

Path Parameters

Name Description Type Required
accountId The unique numeric identifier of the account whose alerts are being retrieved integer (int32) Required

Responses

200 OK The request succeeded and the response body contains the requested data.

Response Body Parameters

Array of:

AccountAlertResponse
Property Description Type
alertId The unique identifier for this alert integer (int32)
allowBillProcessing When true, bills can still be processed despite this alert. When false, the alert blocks bill processing. boolean
beginDate The date the alert becomes active and visible string (date-time)
endDate The date the alert expires and is no longer displayed string (date-time)
message The alert message text displayed to users string
Example Response application/json 
[
  {    "alertId": 1,    "allowBillProcessing": false,    "beginDate": "2026-06-29",    "endDate": "2026-06-29",    "message": "string"
  }
]
404 Not Found The requested resource was not found. Verify the ID or path is correct.