> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Alerts

Returns a paginated list of service alerts on chargers accessible to the authenticated user's current team. Active (unresolved) alerts are listed first, then newest first. By default only active alerts are returned.

<ParamField query="filter[include_resolved]" type="boolean">
  Include resolved alerts in the results. Defaults to `false` (active alerts only).
</ParamField>

<ParamField query="filter[severity]" type="string">
  Filter by severity. One of `info`, `warning`, `critical`.
</ParamField>

<ParamField query="filter[alert_type]" type="string">
  Filter by alert type. Matches the exact type or any type prefixed with it (e.g. `connector_faulted` matches `connector_faulted:2`).
</ParamField>

<ParamField query="filter[site_id]" type="integer">
  Filter by site ID.
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page. Default `25`.
</ParamField>

## Response

Returns a paginated response. Each item in `data` is a service alert object. See [Pagination](/guides/pagination) for the `links` and `meta` envelope.

<ResponseField name="id" type="integer">
  The numeric ID of the alert.
</ResponseField>

<ResponseField name="uuid" type="string">
  The unique UUID of the alert.
</ResponseField>

<ResponseField name="site_id" type="integer">
  The ID of the site the alert belongs to. May be `null`.
</ResponseField>

<ResponseField name="charger_id" type="integer">
  The ID of the charger the alert belongs to.
</ResponseField>

<ResponseField name="charger_connector_id" type="integer">
  The ID of the connector the alert relates to, if applicable. May be `null`.
</ResponseField>

<ResponseField name="alert_type" type="string">
  The alert type identifier (e.g. `charger_offline`, `connector_faulted`, `high_reconnect_rate`).
</ResponseField>

<ResponseField name="label" type="string">
  A human-readable label for the alert type, falling back to the raw `alert_type` when no label is registered.
</ResponseField>

<ResponseField name="severity" type="string">
  The severity level. One of `info`, `warning`, `critical`.
</ResponseField>

<ResponseField name="context" type="object">
  Additional context data captured when the alert was raised. May be `null`.
</ResponseField>

<ResponseField name="cooldown_until" type="string">
  ISO 8601 timestamp until which duplicate alerts of this type are suppressed. May be `null`.
</ResponseField>

<ResponseField name="resolved_at" type="string">
  ISO 8601 timestamp of when the alert was resolved (manually or automatically). `null` while active.
</ResponseField>

<ResponseField name="resolved_by" type="integer">
  The ID of the user who resolved the alert. May be `null`.
</ResponseField>

<ResponseField name="can_resolve" type="boolean">
  Whether the authenticated user is permitted to resolve this alert.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the alert was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the alert was last updated.
</ResponseField>

<ResponseField name="charger" type="object">
  The charger the alert belongs to, with its site.

  <Expandable title="charger">
    <ResponseField name="id" type="integer">
      The numeric ID of the charger.
    </ResponseField>

    <ResponseField name="identity" type="string">
      The charger's OCPP identity string.
    </ResponseField>

    <ResponseField name="uuid" type="string">
      The charger's UUID.
    </ResponseField>

    <ResponseField name="site" type="object">
      The charger's site, with `id` and `name`. May be `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="connector" type="object">
  The connector the alert relates to, with its `id` and `connector_id`. May be `null`.
</ResponseField>

<ResponseField name="actions" type="object[]">
  The remediation actions associated with the alert.

  <Expandable title="action">
    <ResponseField name="id" type="integer">
      The numeric ID of the action.
    </ResponseField>

    <ResponseField name="service_alert_id" type="integer">
      The ID of the alert the action belongs to.
    </ResponseField>

    <ResponseField name="action_type" type="string">
      The type of remediation action.
    </ResponseField>

    <ResponseField name="step_number" type="integer">
      The ordinal position of this action in the remediation sequence.
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the action.
    </ResponseField>

    <ResponseField name="result" type="object">
      The result of executing the action. May be `null`.
    </ResponseField>

    <ResponseField name="scheduled_at" type="string">
      ISO 8601 timestamp of when the action is scheduled. May be `null`.
    </ResponseField>

    <ResponseField name="executed_at" type="string">
      ISO 8601 timestamp of when the action was executed. May be `null`.
    </ResponseField>
  </Expandable>
</ResponseField>