Query Parameters

• startDate (string, optional) - Start date filter (ISO 8601 format)
• endDate (string, optional) - End date filter (ISO 8601 format)
• includeSubCompanies (boolean, optional, default: true) - Include events from sub-companies
• lastDay (boolean, optional) - Get events from the last 24 hours
• last7days (boolean, optional) - Get events from the last 7 days
• last30days (boolean, optional) - Get events from the last 30 days

Usage Examples

Basic Usage

# Get all events (default - includes sub-companies)
GET /v1/company/abc123/events

# Get events from parent company only
GET /v1/company/abc123/events?includeSubCompanies=false

Date Filtering

# Get events from date range
GET /v1/company/abc123/events?startDate=2024-01-01T00:00:00Z&endDate=2024-12-31T23:59:59Z

# Get events from specific date onwards
GET /v1/company/abc123/events?startDate=2024-06-01T00:00:00Z

Preset Filters

# Get events from last 24 hours
GET /v1/company/abc123/events?lastDay=true

# Get events from last 7 days
GET /v1/company/abc123/events?last7days=true

# Get events from last 30 days
GET /v1/company/abc123/events?last30days=true

Combined Filtering

# Last 7 days, excluding sub-companies
GET /v1/company/abc123/events?last7days=true&includeSubCompanies=false

Filter Rules

Valid Combinations

• No filters (returns all events)
• Manual dates only (startDate and/or endDate)
• One preset filter only (lastDay, last7days, or last30days)
• Any date filter + includeSubCompanies

Invalid Combinations

• Multiple preset filters together
• Preset filters + manual date parameters

Examples of Invalid Requests

# Multiple preset filters - NOT ALLOWED
GET /v1/company/abc123/events?lastDay=true&last7days=true

# Mixing preset with manual dates - NOT ALLOWED
GET /v1/company/abc123/events?last7days=true&startDate=2024-01-01T00:00:00Z

Default Behavior

When no parameters are provided:

• Returns ALL events from parent company + sub-companies
• No date restrictions applied

Common Use Cases

Dashboard

GET /v1/company/abc123/events?last30days=true

Company Reports

GET /v1/company/abc123/events?includeSubCompanies=false&startDate=2024-01-01T00:00:00Z

Recent Activity

GET /v1/company/abc123/events?lastDay=true

Response Fields

Key fields in the response:

• uid - Unique event identifier
• name - Event name
• startDate - Event start date (ISO 8601)
• endDate - Event end date (ISO 8601)
• timezone - Event timezone
• isEventLive - Whether event is currently live
• isEventCancelled - Whether event is cancelled
• company - Company information object

Notes

• Date filtering is applied at database level for performance
• Use ISO 8601 format for dates (e.g., 2024-01-15T10:00:00Z)
• Preset filters are more efficient than manual date calculations
• Default behavior includes sub-company events unless explicitly set to false