Skip to main content
GET
List your team's usage alerts
  • Each alert emails at most once a UTC day, or once a billing period for overage and budget_percent, within about a minute of crossing, or, when none of its recipients could be reached then, within 30 minutes of one’s address being verified. A trigger or threshold it hasn’t fired at in that day or period arms it again.
  • Alerts in dollars (overage, budget_percent) email only Owners and Admins, whoever else they name.
  • Members and Tool users see the alerts on calls and the cap; those in dollars (overage, budget_percent) are for Owners and Admins only, and for an API key only with team:manage.
  • Callers: an API key, an MCP OAuth token or a Dashboard session.
  • Permission: usage:read.
  • Effect: Changes nothing.
  • Errors: business_account_required, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor
string

The next_cursor of the previous page

limit
string

Items per page, 1 to 100 (default 20)

Response

One page of alerts

data
object[]
required
next_cursor
string | null
required