---
title: "List all alerts for your account"
method: GET
path: "/v1/check-alerts"
tags: ["Check alerts"]
---

# List all alerts for your account

`GET /v1/check-alerts`

Lists all alerts that have been sent for your account.
Use the `to` and `from` parameters to specify a date range (UNIX timestamp in seconds). This endpoint will return data within a 6-hour timeframe. If the `from` and `to` params are set, they must be at most 6 hours apart. If none are set, we will consider the `to` param to be now and the `from` param to be 6 hours earlier. If only the `to` param is set we will set `from` to be 6 hours earlier. If only the `from` param is set we will consider the `to` param to be 6 hours later.

## 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".

## Headers

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

## Response `200`

Successful

- CheckAlert[]
  - `id` string — The unique ID of this alert.
  - `name` string, required — The name of the check.
  - `checkId` string — The ID of check this alert belongs to.
  - `alertType` 'NO_ALERT' | 'ALERT_FAILURE' | 'ALERT_FAILURE_REMAIN' | 'ALERT_FAILURE_DEGRADED' | 'ALERT_RECOVERY' | 'ALERT_DEGRADED' | 'ALERT_DEGRADED_REMAIN' | 'ALERT_DEGRADED_FAILURE' | 'ALERT_DEGRADED_RECOVERY' | 'ALERT_SSL' — The type of alert.
  - `checkType` 'AGENTIC' | 'API' | 'BROWSER' | 'HEARTBEAT' | 'ICMP' | 'MULTI_STEP' | 'TCP' | 'PLAYWRIGHT' | 'TRACEROUTE' | 'URL' | 'DNS' | 'SSL' | 'GRPC' — The type of the check.
  - `runLocation` string — What data center location this check alert was triggered from.
  - `responseTime` number — Describes the time it took to execute relevant parts of this check. Any setup timeor system time needed to start executing this check in the Checkly backend is not part of this.
  - `error` string, nullable — Any specific error messages that were part of the failing check triggering the alert.
  - `statusCode` string, nullable — The status code of the response. Only applies to API checks.
  - `created_at` string, date — The date and time this check alert was created.
  - `startedAt` string, date — The date and time this check alert was started.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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/9e903da4f3da/schema)