v1

List Alerts

List budget alerts for the organization, newest first.

Optionally filtered by status and source.

Available to all credential types, so an agent can check "is this org near budget?" mid-task.

get/v1/alerts

Request

  • Base URL
    https://api.ellipsis.dev
  • URL
    https://api.ellipsis.dev/v1/alerts
  • Auth
    HTTP bearer

Query parameters

status'open' | 'dismissed' | 'expired'

The alert's lifecycle state: open until a human dismisses it or the system resolves it (the condition cleared or the alert went stale).

source'budget'

What raised the alert.

limitinteger
cursorstring nullable

Headers

user-agentstring nullable

Response

Successful Response

has_moreboolean

Whether more results exist past this page.

next_cursorstring nullable

Pass as cursor to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.

Changes

No recorded changes to this operation across all 1 revision of this API.