Skip to main content
Portal

Stream All Notifications

GET 
/v2/auto/queries/stream
Plan Access
All plans, billed per query in credits
Data Recency
Continuous evaluation against live data
Rate Limit
60 to 120 RPM by plan

Stream notifications for all of your queries over a single connection (SSE).

Use this instead of opening one /queries/{queryId}/stream per query. Events for every query you own arrive on one connection; correlate them with data.queryId.

Cost​

Free.

Auth​

Required header:

x-elfa-api-key: <api_key>

Response Format (SSE)​

id: <outbox-event-uuid>
event: notification
data: {"status":"triggered","title":"...","body":"...","queryId":"<uuid>","timestamp":1743379200000}

A : keep-alive comment is sent every 15s. Only notifications tied to a query are delivered. Events are live-only — there is no replay, and Last-Event-ID is ignored.

Lifecycle​

Open the stream after creating at least one query: the request returns 410 when you have no active queries. Once your last query reaches a terminal state and all of its notifications have been delivered, the stream emits and then closes:

event: end
data: {"code":"USER_STREAM_CLOSED"}

Request​

Responses​

SSE stream established (text/event-stream)