GET
/organization/spend_alerts/{alert_id}Retrieve an organization spend alert
Retrieves an organization-level spend alert by its identifier. Use alert_id to select the alert whose threshold and notification settings you want to inspect.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
alert_idstringrequired
The identifier of the organization spend alert to retrieve.
200Returns the organization spend alert, including its identifier, `organization.spend_alert` object type, threshold amount in cents, USD currency, monthly interval, and notification channel settings.
idstringrequired
The identifier, which can be referenced in API endpoints.
objectstringrequired
The object type, which is always `organization.spend_alert`.
threshold_amountintegerrequired
The alert threshold amount, in cents.
currencystringrequired
The currency for the threshold amount.
intervalstringrequired
The time interval for evaluating spend against the threshold.
notification_channelobjectrequired
Email notification settings for a spend alert.
Error handling
alert_id must identify the organization spend alert you want to retrieve. The returned alert uses the organization.spend_alert object type, evaluates a month interval, and uses USD for its threshold currency.