---
title: "Get usage alerts for a subscription"
method: GET
path: "/alerts/subscriptions/{subscriptionId}/usage"
tags: ["Alerts"]
---

# Get usage alerts for a subscription

`GET /alerts/subscriptions/{subscriptionId}/usage`

## Path parameters

- `subscriptionId` string, required

## Response `200`

The list of current and available alerts for the subscription.

- object
  - `available` Alert[] — The list of available usage alerts.
    - `id` string — The identification of the alert type.
    - `active` boolean — Whether the alert is currently active.
    - `alerts_sent` integer — The amount of alerts of this type that have been sent so far.
    - `last_alert_at` string, date-time — The time the last alert has been sent.
    - `updated_at` string, date-time — The time the alert has last been updated.
    - `config` object — The alert type specific configuration.
  - `current` Alert[] — The list of the current usage alerts.
    - `id` string — The identification of the alert type.
    - `active` boolean — Whether the alert is currently active.
    - `alerts_sent` integer — The amount of alerts of this type that have been sent so far.
    - `last_alert_at` string, date-time — The time the last alert has been sent.
    - `updated_at` string, date-time — The time the alert has last been updated.
    - `config` object — The alert type specific configuration.

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)