Skip to content
IForevents Docs
IForevents Docs
HomeDashboardGitHubPrivacyTermsSecurityIntroduction
Support and SLA

The events or users behind one insights point

POST
/v1/analytics/insights/drilldown

Takes the chart's own insights request plus point (the t of one of its points; omitted for the whole window), key and other (the breakdown series), show (events or users), limit (1 to 100, default 50) and offset (at most 10000). Reads the point's bucket clipped to [start, end), under the same project and filters. total_events and total_users are the point's event count and unique users. Events are newest first; users by event count, then user. Other is every value outside the chart window's top values.

Authorization

AuthorizationBearer <token>

Session token issued by the accounts service (or the legacy /v1/auth routes).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/analytics/insights/drilldown" \  -H "Content-Type: application/json" \  -d '{    "breakdown": {      "property": "plan",      "scope": "event"    },    "end": "2026-09-13T12:30:45Z",    "interval": "day",    "key": "pro",    "limit": 50,    "metric": "total",    "point": "2026-09-02T05:00:00Z",    "show": "users",    "start": "2026-09-01T00:00:00Z",    "timezone": "America/Bogota"  }'
{  "has_more": false,  "limit": 50,  "offset": 0,  "total_events": 42,  "total_users": 7,  "users": [    {      "events": 12,      "first_seen": "2026-09-02T06:10:00Z",      "last_seen": "2026-09-02T22:41:00Z",      "user_uuid": "6f1c2d3e-0000-4000-8000-000000000001"    }  ],  "window": {    "end": "2026-09-03T05:00:00Z",    "start": "2026-09-02T05:00:00Z"  }}
breakdown?
breakdown_limit?integer

Values listed before the rest are summed into one Other series (key $other); 1 to 25, default 10. With interval total, 1 to 1000.

compare?
end?string
Formatdate-time
event?string
filters?array<>
groups?array<>
interval?string

hour, day (default), week (Monday-start) or month buckets of the local calendar of timezone; total has no buckets: every series carries only its whole-window total and points is empty.

key?string
limit?integer
match?string
metric?string
offset?integer
other?boolean
point?string
Formatdate-time
property?string
show?string
start?string
Formatdate-time
timezone?string