Skip to main content
GET
Get a meeting

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

Path Parameters

meeting_id
string<uuid>
required

Response

The meeting and available artifacts.

is_external
boolean
required
read-only

True when this record has an active integration link, including an export from Vega. This is current linkage, not historical origin, and is independent of linked contacts or households. Associated records cannot be patched or deleted through this API, except that a meeting may patch reviewed alone. No provider/account details are exposed.

id
string<uuid>
required
topic
string | null
required
start_time
string<date-time> | null
required
duration_minutes
number | null
required
format
string | null
required

Stored meeting format, usually in_person, video_call or phone_call. Older or synced records may carry other values.

meeting_type
object | null
required
reviewed
boolean
required
has_note
boolean
required
has_preparation
boolean
required
contacts
object[]
required

Linked contacts the connected user can see.

households
object[]
required

Linked households the connected user can see.

created_on
string<date-time> | null
required
updated_on
string<date-time> | null
required
owner
object | null
required
creator
object | null
required
description
string | null
required
location
string | null
required
join_url
string | null
required

The meeting join link, when available.

participants
string[]
required

Participant names, email addresses or phone numbers available to the connected user. This is not a complete attendance roster.

preparation
object | null
required

Most recently created non-deleted preparation, or null. Earlier versions are not returned.

note
object | null
required

Most recently created non-deleted meeting note, or null. Separate from standalone /notes records. Earlier versions and meeting analytics are not returned.

transcript
string | null
required

Full stored transcript: WebVTT preserves speaker and timing information; text uses Speaker: message lines. Null when unavailable.

transcript_format
enum<string> | null
required
Available options:
webvtt,
text,
null
recording_url
string | null
required

Authorized recording read/download URL, or an external provider link. Vega storage links are temporary and may expire with the signing credentials; fetch the meeting again for a fresh URL. External providers may require their own login.

video_recording_url
string | null
required

Temporary authorized video read/download URL, when available. Fetch the meeting again if the link expires.