API ReferenceMeetings

List meetings

Beta

Retrieve a paginated list of meetings with optional keyword search (across title, AI summary, and cached transcript text), participant email filtering, attendee domain filtering, date range filtering, and sorting.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

querystring or nullOptional
Keyword to search across meeting title, AI summary, and cached transcript text
participant_emailslist of strings or nullOptional

Participant email(s) to filter by. Repeat the parameter or pass a comma-separated list.

participant_matchenumOptionalDefaults to any
Whether a meeting must include any or all of the given participant emails
Allowed values:
participant_domainslist of strings or nullOptional

Attendee email domain(s) to filter by (e.g. ‘acme.com’). Repeat the parameter or pass a comma-separated list.

domain_matchenumOptionalDefaults to any
Whether a meeting must include attendees from any or all of the given domains
Allowed values:
created_afterdatetime or nullOptional
Only include meetings created at or after this ISO 8601 timestamp
created_beforedatetime or nullOptional
Only include meetings created at or before this ISO 8601 timestamp
sort_byenumOptionalDefaults to created_at
Field to sort by
Allowed values:
sort_directionenumOptionalDefaults to desc
Sort direction
Allowed values:
limitintegerOptional1-500Defaults to 50

Maximum number of meetings to return per page (1-500)

offsetintegerOptional>=0Defaults to 0
Number of meetings to skip for pagination

Response

Successfully retrieved paginated list of meetings
has_moreboolean
Whether there are more meetings available beyond this page
itemslist of objects
Array of meeting objects for the current page
limitinteger

Maximum number of meetings returned in this response (1-500)

next_offsetinteger or null
Offset value to use for the next page request, null if no more pages
offsetinteger
Number of meetings skipped from the beginning of the result set
totalinteger
Total number of meetings matching the query filters

Errors

422
Unprocessable Entity Error