Introducing the Better Auth Chargebee plugin: Use it to handle subscriptions, billing, and auth seamlessly.Try now
Chargebeechargebee API

List alert statuses for an alert

Returns the runtime state of a specific alert across all impacted subscriptions. Each entry indicates whether a subscription is within_limit or in_alarm for the given alert.

Use this endpoint to monitor which subscriptions are currently breaching a threshold, for example when building internal dashboards or CSM workflows.

Prerequisites & Constraints

  • The alert_id must reference a global alert. Subscription-scoped alerts return a 400 error since they apply to only one subscription — use Retrieve alert status instead.

Sample Request

List alert statuses for a global alert, filtered by in_alarm

Sample Result[JSON]

URL Format

GET https://[site].chargebee.com/api/v2/alerts/{alert-id}/alert_statuses

Input Parameters

limit
optional, integer, default=10, min=1, max=100

optional, integer

Maximum number of results to return.

Example → limit = 25

offset
optional, string, max chars=1000

optional, string

Pagination cursor returned by a previous list call. Use the next_offset value from the previous response.

Filter Params

For operator usages, see the Pagination and Filtering section.
alarm_status[<operator>]

optional, enumerated string filter

Filter by alarm_status to find subscriptions in a specific runtime state.

Example → alarm_status[is] = "in_alarm"

Supported operators: is

Returns

next_offset
optional, string, max chars=1000

Returned only if more results are available. Pass this value as offset in the next request to fetch the next page.

alert_status
Alert status object
Resource object representing alert_status