Event Analytics API

Retrieve aggregated analytics data about events, including trends and breakdowns by event type.

GET /events-analytics

Get aggregated event analytics for the active Organizational Unit.

Request

Parameter	Type	Required	Description
range	string	No	Date range: today, yesterday, last_7d, last_30d, last_90d
event_type	string	No	Filter by specific event type

Response

200 OK

{
  "total_events": 12500,
  "unique_leads": 850,
  "events_by_type": {
    "page_view": 8500,
    "email_open": 2200,
    "form_submit": 1100,
    "demo_request": 700
  },
  "daily_counts": [
    {"date": "2025-01-15", "count": 420},
    {"date": "2025-01-14", "count": 385}
  ]
}

Response Fields

Field	Type	Description
total_events	integer	Total events in the period
unique_leads	integer	Number of unique leads with events
events_by_type	object	Event counts broken down by type
daily_counts	array	Daily event totals

Example

curl -X GET "https://api.leadvibe.com/events-analytics?range=last_30d" \
  -H "Authorization: Bearer <token>"

Common Errors

Status	Meaning	Solution
401	Unauthorized	Check authentication token
500	Server Error	Contact support if persists

---

Notes

• Analytics data is OU-scoped to the active Organizational Unit
• Data is aggregated in real-time from ingested events

Related Endpoints

• Events - List individual events
• Event Statistics - Summary statistics