List Alerts

GET /v3/service/alerts

List Alerts

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/service/alerts \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 123,
  "uuid": "<string>",
  "status": "<string>",
  "severity": "<string>",
  "title": "<string>",
  "description": "<string>",
  "acknowledged_at": "<string>",
  "resolved_at": "<string>",
  "created_at": "<string>",
  "alert": {
    "alert_type": "<string>",
    "context": {},
    "charger": {},
    "connector": {}
  },
  "comments": [
    {}
  ],
  "activities": [
    {}
  ]
}

Returns a list of all service alert tickets for the authenticated user’s teams.

filter[status] · string

Filter by status. One of open, acknowledged, in_progress, resolved, auto_resolved.

filter[severity] · string

Filter by severity. One of info, warning, critical.

filter[alert_type] · string

Filter by alert type or type prefix.

filter[site_id] · integer

Filter by site ID.

Response

id · integer

The numeric ID of the alert ticket.

uuid · string

The unique UUID of the alert ticket.

status · string

The current status of the ticket. One of open, acknowledged, in_progress, resolved, auto_resolved.

severity · string

The severity level. One of info, warning, critical.

title · string

The alert title.

description · string

The alert description, or null.

acknowledged_at · string

ISO 8601 timestamp of when the ticket was acknowledged, or null.

resolved_at · string

ISO 8601 timestamp of when the ticket was resolved, or null.

created_at · string

ISO 8601 timestamp of when the ticket was created.

alert · object

The underlying alert definition and context.

Show alert

alert_type · string

The type identifier for the alert.

context · object

Additional context data for the alert.

charger · object

The charger associated with the alert.

connector · object

The connector associated with the alert, if applicable.

comments · array

The comments on the ticket.

activities · array

The activity log entries for the ticket.