---
title: "List alarms"
method: GET
path: "/api/v1/alarms"
tags: ["Alarms"]
---

# List alarms

`GET /api/v1/alarms`

The key owner's alarms, newest first, paginated. Filter by `status`, `direction`
or `notification` channel.

## Query parameters

- `page` integer, nullable — Page number (1-based).
- `per_page` integer, nullable — Rows per page (1–100, default 25).
- `status` string, nullable — Filter by state: `active` or `triggered`.
- `direction` string, nullable — Filter by trigger direction: `above` or `below`.
- `notification` string, nullable — Filter by delivery channel: `email`, `push` or `webhook`.

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `name` string
    - `coin` object
      - `slug` string
      - `symbol` string
      - `name` string
    - `metric` string
    - `direction` string
    - `target` string
    - `notification` string
    - `status` string
    - `created_at` string
  - `meta` object
    - `current_page` integer
    - `per_page` integer
    - `total` integer
    - `last_page` integer

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)