List a meeting's recordings

GET/v1/meetings/{id}/recordings

A recording is one session of the meeting: its transcript and, when there is one, its audio or video. Recordings come from the Lightfield notetaker, Gong, Granola, or an upload. Only uploaded recordings can be created or given media through the API. Returns every recording on the meeting without media URLs; retrieve a single recording for its media. Requires full access to the meeting; a caller who sees only its metadata gets a 403.

Required scope: meetings:read

Rate limit category: Read

Path ParametersExpand Collapse

id: string

Unique identifier of the meeting.

ReturnsExpand Collapse

MeetingListRecordingsResponse object { data, object }

data: array of object { id, isCanonical, provider, 3 more }

Every recording on the meeting. Media is not included.

id: string

Unique identifier of the recording.

isCanonical: boolean

Whether this is the meeting’s primary recording, the one summaries and $transcript use.

provider: "RECALL" or "GONG" or "GRANOLA" or "UPLOAD"

Where the recording came from: RECALL (Lightfield notetaker), GONG, GRANOLA, or UPLOAD.

One of the following:

"RECALL"

"GONG"

"GRANOLA"

"UPLOAD"

recordedAt: string

When the provider recorded it, in ISO 8601. Null if unknown.

recordedBy: string

Display name of who recorded or uploaded it. Not a member reference.

transcript: object { fileId }

The transcript text file. Null for older notetaker recordings.

fileId: string

File ID of the transcript. Read its text through GET /v1/files/{id}/url.

object: string

Always list.

List a meeting's recordings

curl https://api.lightfield.app/v1/meetings/$ID/recordings \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY"

{
  "data": [
    {
      "id": "id",
      "isCanonical": true,
      "provider": "RECALL",
      "recordedAt": "recordedAt",
      "recordedBy": "recordedBy",
      "transcript": {
        "fileId": "fileId"
      }
    }
  ],
  "object": "object"
}

Returns Examples

{
  "data": [
    {
      "id": "id",
      "isCanonical": true,
      "provider": "RECALL",
      "recordedAt": "recordedAt",
      "recordedBy": "recordedBy",
      "transcript": {
        "fileId": "fileId"
      }
    }
  ],
  "object": "object"
}