The Alert object

Attributes

id string Unique identifier for the object.
object string, value is "billing.alert" String representing the object’s type. Objects of the same type share the same value.
alert _ type enum Defines the type of the alert. Possible enum values usage_threshold Use usage_threshold if you intend for an alert to fire when a usage threshold on a meter is crossed.
livemode boolean If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.
status nullable enum Status of the alert. This can be active, inactive or archived.
title string Title of the alert.
usage _ threshold nullable object Encapsulates configuration of the alert to monitor usage on a specific Billing Meter.

The Alert object

{ "id": "alrt_12345", "object": "billing.alert", "title": "API Request usage alert", "livemode": true, "alert_type": "usage_threshold", "usage_threshold": { "gte": 10000, "meter": "mtr_12345", "recurrence": "one_time" }, "status": "active"}

Create a billing alert

POST / v1 / billing / alerts

Creates a billing alert

Parameters

alert _ type enum Required The type of alert to create. Possible enum values usage_threshold Use usage_threshold if you intend for an alert to fire when a usage threshold on a meter is crossed.
title string Required The title of the alert. The maximum length is 256 characters.
usage _ threshold object The configuration of the usage threshold.

Returns

Returns a billing alert

Response

{ "id": "alrt_12345", "object": "billing.alert", "title": "API Request usage alert", "livemode": true, "alert_type": "usage_threshold", "usage_threshold": { "gte": 10000, "meter": "mtr_12345", "recurrence": "one_time" }, "status": "active"}

Retrieve a billing alert

GET / v1 / billing / alerts /:id

Retrieves a billing alert given an ID

Parameters

No parameters.

Returns

Returns the alert

Response

{ "id": "alrt_12345", "object": "billing.alert", "title": "API Request usage alert", "livemode": true, "alert_type": "usage_threshold", "usage_threshold": { "gte": 10000, "meter": "mtr_12345", "recurrence": "one_time" }, "status": "active"}