Events API

Query aggregated bot events across all your bots.

List Events

GET /events

Returns a paginated list of events from all bots belonging to the authenticated user.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
page_size	integer	Items per page (default: 20, max: 100)
event_type	string	Filter by event type
bot_id	integer	Filter by specific bot
platform	string	Filter by platform (google, zoom, teams)
start_date	string	Filter events after this ISO date
end_date	string	Filter events before this ISO date

Example

curl "https://api.meetbot.dev/v1/events?page=1&page_size=20&platform=google" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "events": [
    {
      "id": 42,
      "botId": 5,
      "botName": "MeetBot",
      "platform": "google",
      "eventType": "IN_CALL",
      "eventTime": "2024-01-15T10:30:00Z",
      "data": {
        "meetingTitle": "Team Standup"
      },
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 150,
  "page": 1,
  "page_size": 20
}

Event Object

Field	Type	Description
id	integer	Unique event ID
botId	integer	Bot that generated the event
botName	string	Display name of the bot
platform	string	Meeting platform
eventType	string	Type of event
eventTime	datetime	When the event occurred
data	object	Event-specific payload
createdAt	datetime	When the record was created

Event Types

Bot Lifecycle

Event Type	Description
JOINING_CALL	Bot is attempting to join the meeting
IN_WAITING_ROOM	Bot is in the meeting waiting room
IN_CALL	Bot has joined the meeting
CALL_ENDED	Meeting has ended
DONE	Bot has completed its task
FATAL	An unrecoverable error occurred

Recording Events

Event Type	Description
RECORDING	Recording has started

Filtering Examples

# Events for a specific bot
curl "https://api.meetbot.dev/v1/events?bot_id=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Only error events
curl "https://api.meetbot.dev/v1/events?event_type=FATAL" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Events in a date range
curl "https://api.meetbot.dev/v1/events?start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"