Skip to main content
POST

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
keywords
string[]

Words to search for. Required unless cursor is set. An entry matches when all its words are said close together, in any order; a note needs only one entry to match. Synonyms and other spellings are not matched, so add them as separate entries.

Required array length: 1 - 20 elements
Required string length: 1 - 100
​
participant
string

Only meetings with this person or company on the calendar invite, or where they are named as a speaker: a name, email, company or domain. A meeting matched only by speaker name returns just the parts where they spoke.

Required string length: 1 - 200
​
from_date

Only meetings that started at or after this date or UTC timestamp. A date means midnight UTC. Notes without a calendar event use their creation time.

Example:

"2026-01-27"

​
to_date

Only meetings that started at or before this date or UTC timestamp. A date means midnight UTC at the start of that day, so it leaves out meetings later that day.

Example:

"2026-01-27"

​
page_size
integer
default:10

Maximum number of notes to return per page

Required range: 1 <= x <= 30
Example:

10

​
cursor
string

The cursor from the previous response, to fetch the next page. Send it alone or with page_size. Cursors expire after 15 minutes.

Required string length: 1 - 2048

Response

Matching notes with transcript excerpts, and whether there are more pages

​
notes
object[]
required
​
hasMore
boolean
required

Whether there is another page. A page can hold fewer notes than page_size, or none, and still have more, so keep requesting with cursor until this is false.

​
cursor
string | null
required

The next-page cursor, or null when hasMore is false.

​
completion_status
enum<string>
required

more_available: fetch the next page with cursor. exhausted: there are no more matches. incomplete: the search stopped after examining 10,000 notes without finishing; narrow it and search again.

Available options:
more_available,
exhausted,
incomplete