List applicable alerts for a subscription

Returns the effective set of alert configurations for a given subscription. This includes global alerts (filtered by the subscription's plan) and any subscription-scoped alerts, giving you a single view of all threshold rules in force.

Use this endpoint when building subscription dashboards or evaluating which alerts apply to a specific customer.

Note: This endpoint returns alert configurations only. To check the runtime state (whether alerts are currently within_limit or in_alarm), use List alert statuses for a subscription.

Sample Request

Get applicable alert configurations for a subscription

Sample Result[JSON]

URL Format

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

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.

status[<operator>]

optional, enumerated string filter

Filter by status.

Example → status[is] = "enabled"

Supported operators: is

type[<operator>]

optional, enumerated string filter

Filter by type. Supported values are usage_exceeded and spend_exceeded.

Example → type[is] = "spend_exceeded"

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

Alert object

Resource object representing alert