Skip to main content
GET
/
api
/
v1
/
captures
/
{id}
Get a capture
curl --request GET \
  --url https://api.parable.so/api/v1/captures/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "summary": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "duration_ms": 123,
  "device": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "participants": [
    {
      "label": "<string>",
      "name": "<string>",
      "email": "<string>",
      "matched": true,
      "match_confidence": 123,
      "speech_ms": 123
    }
  ],
  "segments": [
    {
      "start_ms": 123,
      "end_ms": 123,
      "speaker": "<string>",
      "text": "<string>"
    }
  ],
  "transcript_text": "<string>",
  "calendar_event": null,
  "emitted_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Workspace API key (parable_...), minted in the Parable app under Settings → API.

Path Parameters

​
id
string<uuid>
required

Capture id (UUID).

Response

The transcript document.

One finished capture with its full transcript.

​
id
string<uuid>
required

Capture id — the stable key for deduplication.

​
workspace_id
string<uuid>
required
​
mode
enum<string>
required

ambient = device-initiated on speech; manual = user-initiated recording.

Available options:
ambient,
manual
​
title
string
required

Model-generated after processing; falls back to a generic label.

​
summary
string | null
required

Model-generated; may be null.

​
started_at
string<date-time>
required
​
ended_at
string<date-time> | null
required
​
duration_ms
integer | null
required
​
device
object
required

The capturing device — the room, in practice: devices are named after where they live.

​
participants
object[]
required
​
segments
object[]
required

The source of truth — time-ordered utterances with speaker attribution.

​
transcript_text
string
required

Convenience plain-text rendering of the segments, one speaker-labeled line per consecutive same-speaker run.

​
calendar_event
null
required

Reserved for the Google Calendar integration; always null today. Additive later — no schema break.

​
emitted_at
string<date-time>
required

When this document was rendered.