# List Gas Station Alarms

The Gas Station's open alarms about your funding wallets, your policies and your wallets' top-ups.

## Overview

- `kind`: `gas_funding_low` — one of your funding wallets could not pay a top-up; `gas_price_above_max` — the network's gas price is above one of your policies' maximum; `gas_topup_failed` — a top-up of one of your wallets failed. When each is raised and resolved: [Gas Station](https://docs.aureahub.com/docs/guide-gas-station.md) › Alarms.
- One alarm per subject — a funding wallet, a policy, a wallet — while it is open: raised again, it counts `occurrences` and moves `lastSeenAt`, and its `detail` is the latest. `detail` holds ids, the chain's id, the asset, amounts and a code — never an address.
- Open alarms only, up to 200, the most recently seen first: an alarm leaves the list once it is resolved, or once Aurea acknowledges it.
- For `owner`, `tenantadmin`, `non_signing_admin`, `signer`, `approver`, `editor`, `viewer` and `auditor`, on their own tenant.

## Endpoint

### `GET /v1/gas-station/alarms`

Authentication: bearer token required.

The Gas Station's open alarms about your tenant.

**Responses**

`200` OK

```json
{
  "alarms": [
    {
      "id": "9a4c7e1f-3d6b-4e82-b5a0-1c8f2d7e4b39",
      "kind": "gas_funding_low",
      "detail": {
        "fundingWalletId": "2d9f4a6c-8e1b-4c73-a5d0-7b3e9f1c6a28",
        "chainId": 8453,
        "asset": "native",
        "balance": "300000000000000",
        "needed": "910000000000000"
      },
      "occurrences": 4,
      "raisedAt": "2026-10-14T11:57:02.611Z",
      "lastSeenAt": "2026-10-14T12:00:04.452Z"
    },
    {
      "id": "e1b6d3a8-5f2c-4b97-8d40-6a9e3c1f7b25",
      "kind": "gas_topup_failed",
      "detail": {
        "walletId": "5f3a9c1e-2d7b-4e60-8b4a-9c1d6e3f2a78",
        "topUpId": "4b8e2c6a-1f9d-4a35-b7e0-3d5c9a1f6e42",
        "chainId": 8453,
        "asset": "native",
        "code": "INSUFFICIENT_FUNDS"
      },
      "occurrences": 1,
      "raisedAt": "2026-10-14T11:54:01.097Z",
      "lastSeenAt": "2026-10-14T11:54:01.097Z"
    }
  ]
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/gas-station/alarms \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## By Tenant Id

The same, with your tenant's id, for the same roles; another tenant's id answers `403`.

### `GET /v1/admin/tenants/{id}/gas-station/alarms`

Authentication: bearer token required.

The Gas Station's open alarms about the tenant.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | Your tenant's id |

**Responses**

`403` Another tenant

```json
{ "statusCode": 403, "error": "ForbiddenError", "message": "Admin access required or you can only access your own tenant." }
```

---

Web version: https://docs.aureahub.com/#gas-station-alarms