GET/organization/spend_alerts

List organization spend alerts

Lists spend alerts configured for the organization. Use limit and order to control the result page, and use after or before to navigate from a spend alert in a previous response. The response includes cursor IDs and a has_more flag for pagination.

4 parameters
limitintegeroptional
Maximum number of spend alerts to return, from 0 to 100. Defaults to 20 when omitted.
orderstringoptional
Sort order for the returned spend alerts: `asc` or `desc`. Defaults to `asc` when omitted.
Allowed:ascdescDefault:asc
afterstringoptional
Cursor containing the ID of the last spend alert in the previous response; use it to fetch the next page.
beforestringoptional
Cursor containing the ID of the first spend alert in the previous response; use it to fetch the previous page.

4 status codes
200Returns a paginated list of organization spend alerts with the current page of alert objects, the first and last alert IDs, and a `has_more` flag.
objectstringrequired
Always `list`.
Allowed:list
dataarray<object>required
Spend alerts returned in the current page.
first_idstringrequired
The ID of the first spend alert in this page.
last_idstringrequired
The ID of the last spend alert in this page.
has_morebooleanrequired
Whether more spend alerts are available when paginating.
400Returned when the spend alert listing parameters are invalid.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404Returned when the spend alert specified by the `after` cursor was not found.
errorobjectrequired

Error handling

A 400 is returned when the spend alert listing parameters are invalid. A 403 is returned when the authenticated user does not have permission, and a 404 is returned when the spend alert specified by the after cursor is not found. limit must be between 0 and 100; order must be asc or desc.