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

List alert statuses for a subscription

Returns the runtime state of all alerts for a given subscription. Each entry in the response indicates whether the subscription is within_limit or in_alarm for a specific alert.

Use this endpoint to build a subscription-level dashboard showing which thresholds have been breached and when.

Note: This endpoint returns runtime state, not alert configurations. To retrieve the alert rules that apply to a subscription, use List applicable alerts.

Sample Request

List alert statuses for a subscription

Sample Result[JSON]

URL Format

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

Input Parameters

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

optional, integer

Maximum number of results to return.

Example → limit = 10

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 alerts in a specific runtime state.

Example → alarm_status[is] = "in_alarm"

Supported operators: is
alert_id[<operator>]

optional, string filter

Filter by alert_id to find the status for a specific alert.

Example → alert_id[is] = "alert___dev__3Nl7purV3LwbKYH"

Supported operators: in

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