Skip to main content
GET
List meetings

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization code flow with PKCE (S256). See the authorization guide.

Scopes

meetings:read

Read your meetings, preparations, notes, email drafts, transcripts and recordings

Query Parameters

contact_id
string<uuid>

Meetings linked to this contact or one of its households.

household_id
string<uuid>

Meetings linked to this household or one of its members. Give contact_id or household_id, not both.

query
string

Search meeting topics by all-word matches or similar full-query matches.

Maximum string length: 250
start_time_from
string<date-time>

Inclusive lower bound on meeting start time. Include a time zone offset; encode + as %2B.

start_time_to
string<date-time>

Inclusive upper bound on meeting start time. Must be at or after start_time_from.

has_note
boolean
default:false

When true, return only meetings with a saved note. False or omitted does not filter.

has_preparation
boolean
default:false

When true, return only meetings with a saved preparation. False or omitted does not filter.

reviewed
boolean

True selects reviewed meetings; false selects unreviewed meetings. Omit for both.

order
enum<string>
default:newest_first

Sort by start time, with the meeting id as a tie breaker. When searching, all-word topic matches come first.

Available options:
newest_first,
oldest_first
page
integer
default:1

The page number to return, from 1 to 1,000. This is separate from the records-per-page limit.

Required range: 1 <= x <= 1000
limit
integer
default:50

Records per page, at most 100.

Required range: 1 <= x <= 100

Response

A page of meeting summaries.

page
integer
required
Required range: 1 <= x <= 1000
limit
integer
required
Required range: 1 <= x <= 100
has_more
boolean
required

Whether the next page has rows.

data
object[]
required