Skip to main content
GET
List alerts

Authorizations

Authorization
string
header
required

Your v3 API key, e.g. ask_live_…

Headers

X-Subaccount-Id
string

Target subaccount for the request. Required unless the API key is authorized for exactly one subaccount (then it defaults to that one). Omitting it on a multi-subaccount key returns 400 subaccount_required.

Query Parameters

limit
integer

Max rows to return (1–100, default 50).

Required range: 1 <= x <= 100
status
enum<string>

Filter by resolution status.

Available options:
OPEN,
ACKNOWLEDGED,
RESOLVED,
DISMISSED
assistant_id
string

Filter by assistant id.

monitor_rule_id
string

Filter by the rule that produced the alert.

contact_id
string

Filter by local contact id (observations created after ASSIST-420).

ghl_contact_id
string

Filter by GoHighLevel contact id (observations created after ASSIST-420).

category
enum<string>

Alert category: COMPLIANCE, QUALITY, SAFETY, ESCALATION, or CUSTOM.

Available options:
COMPLIANCE,
QUALITY,
SAFETY,
ESCALATION,
CUSTOM
severity
enum<string>

Severity: LOW, MEDIUM, HIGH, or CRITICAL.

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL
triggered
boolean

Filter by whether the rule actually triggered. Defaults to true (only triggered alerts).

start_date
string

ISO-8601 lower bound on creation time (inclusive).

end_date
string

ISO-8601 upper bound on creation time (inclusive).

Response

Success

data
object[]
required
request_id
string
required
error
null