Observability

Overview API

Two endpoints that mirror the dashboard's home screen: a one-shot aggregated summary and a polling feed of recent events. Both are designed for low-friction integration into your own dashboards.

Aggregated overview#

GET/api/overview

Returns a single response that bundles totals, top proxies, error rates, latency distributions and recent events for a given time range. This is the same payload the dashboard's overview screen consumes.

Query

range

enum

24h (default) or 7d.

curl "https://app.aironclaw.com/api/overview?range=24h" \
  -H "Authorization: Bearer $AIFW_PAT"

Live event feed#

GET/api/overview/feed

Returns events newer than since, newest first. Designed for ~5-second polling — pass the timestamp of the most recent event you've already seen as since on each subsequent call. The dashboard uses the same shape for its live feed.

Query

since

epoch seconds

Only return events strictly newer than this. Default 0 (returns the most recent batch).

limit

number

Max events to return. Default 20.

curl "https://app.aironclaw.com/api/overview/feed?since=1735689600&limit=20" \
  -H "Authorization: Bearer $AIFW_PAT"