---
title: "Get usage-alert settings"
method: GET
path: "/billing/usage-alerts"
tags: ["billing"]
---

# Get usage-alert settings

`GET /billing/usage-alerts`

Returns the organization's balance-alert configuration and any currently open alerts (low balance, negative balance).

## Response `200`

OK

- SubscriptionUsageAlertSettingsResponse — The org's usage-alert configuration and any open alerts.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `active_alerts` SubscriptionActiveUsageAlert[], nullable, required — Currently open alerts, oldest first. Empty when the balance is healthy.
    - `balance_cents` integer, required — The balance when the alert opened, in cents. May be negative.
    - `kind` 'low_balance' | 'negative_balance', required — Which rule fired: the configurable low-balance threshold, or the balance going negative.
    - `threshold_cents` integer, required — The threshold in effect when the alert opened, in cents (0 for negative_balance).
    - `triggered_at` string, date-time, required — When the alert opened.
  - `enabled` boolean, required — Whether low-balance alerts are active. Negative-balance alerts are always on.
  - `threshold_cents` integer, required — Alert while the balance sits below this amount, in cents. Must be positive.

## Other responses

- `default` — Error

---

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