---
title: "Get Alerts Stats"
method: GET
path: "/v2/alerts/statistics"
---

# Get Alerts Stats

`GET /v2/alerts/statistics`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/v2/alerts/statistics`
- Auth: none declared

Get alerts statistics with filtering.

This endpoint returns statistics about alert events including total count,
noise reduction, and average response time for escalated alerts.

Args:
    authorized_user: Authorized user with organization context
    start_time: Optional start time filter (ISO 8601 format) - filters by fired_at
    end_time: Optional end time filter (ISO 8601 format) - filters by fired_at

Returns:
    AlertsStatsV2Response containing alert statistics

## Query parameters

- `start_time` string, nullable: Start time filter (ISO 8601 with zero offset)
- `end_time` string, nullable: End time filter (ISO 8601 with zero offset)

## Response `200`

Successful Response

- AlertsStatsV2Response: Response model for V2 alerts statistics.
  - `total_alerts` integer, required: Total number of alerts
  - `avg_response_time` number, nullable: Average response time in minutes (None if no escalated alerts)
  - `median_escalation_response_time` number, nullable: Median escalation response time in minutes (None if no escalated alerts)
  - `num_investigated_alerts` integer, required: Number of anomalous alerts that were triggered for investigation (trigger_decision='triggered')
  - `num_noisy_alerts` integer, required: Number of noisy alerts (trigger_decision!='triggered')
  - `noise_reduction` number, required: Noise reduction percentage (0-100)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)