---
title: "Lists all alert notifications"
method: GET
path: "/v1/alert-notifications"
tags: ["Alert notifications"]
---

# Lists all alert notifications

`GET /v1/alert-notifications`

Lists the alert notifications that have been sent for your account. You can filter by alert channel ID or limit to only failing notifications.
Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). This endpoint will return data within a 24-hour timeframe. If the `from` and `to` params are set, they must be at most 24 hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be 24 hours earlier. If only the `to` param is set we will set `from` to be 24 hours earlier. If only the `from` param is set we will consider the `to` param to be 24 hours later.
**Rate-limiting is applied to this endpoint, you can send 5 requests / 10 seconds at most.**

## Query parameters

- `limit` integer — Limit the number of results
- `page` number — Page number
- `from` string, date — Select records up from this UNIX timestamp (>= date). Defaults to now - 6 hours.
- `to` string, date — Optional. Select records up to this UNIX timestamp (< date). Defaults to 6 hours after "from".
- `alertChannelId` integer — Limit results to an alert channel
- `hasFailures` boolean — Sending the alert notification was unsuccessful

## Headers

- `x-checkly-account` string — Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- AlertNotification[]
  - `id` string — The unique ID of this alert notification.
  - `type` 'EMAIL' | 'SLACK' | 'SLACK_APP' | 'WEBHOOK' | 'SMS' | 'PAGERDUTY' | 'OPSGENIE' | 'CALL' — The type of alert channel (SMS, Slack, Webhook, etc).
  - `status` 'IN_PROGRESS' | 'SUCCESS' | 'FAILURE' | 'RATE_LIMITED' — The status of the alert.
  - `alertConfig` AlertConfig — The configuration which was used to send the alert.
  - `notificationResult` string, nullable — The result of sending the alert notification.For example, this could be the response body of the Webhook.
  - `timestamp` string, date-time, nullable — The time that the alert was sent.
  - `checkType` 'AGENTIC' | 'API' | 'BROWSER' | 'HEARTBEAT' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC' — The type of the check.
  - `checkId` string — The ID of the check.
  - `checkAlertId` string — The ID of the check alert.
  - `alertChannelId` number — The ID of the alert channel which this alert was sent to.
  - `checkResultId` string — The ID of the corresponding check result.

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/checklyhq/apis/checkly-public-api.md) · [All operations](https://skmtc.net/checklyhq/apis/checkly-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checklyhq/checkly-public-api/revisions/87d29dc7b4fe/schema)