---
title: "Get a meeting summary"
method: GET
path: "/meetings/{id}/summary"
tags: ["Meetings"]
---

# Get a meeting summary

`GET /meetings/{id}/summary`

## Request

- Base URL: `https://app.pencil.ink/api/v1`
- URL: `https://app.pencil.ink/api/v1/meetings/{id}/summary`
- Auth: HTTP bearer

## Response `200`

A meeting summary.

- object
  - `data` MeetingSummary
    - `id` string
    - `noteId` string
    - `title` string
    - `source` 'fireflies' | 'tldv' | 'google_meet' | 'microsoft_teams' | 'recall' | 'email' | 'manual'
    - `externalId` string, nullable
    - `meetingAt` integer, nullable: Epoch ms.
    - `durationSec` integer, nullable
    - `participants` MeetingParticipant[]
      - `name` string
      - `email` string
    - `organizerEmail` string, nullable
    - `summary` string, nullable
    - `summaryStatus` 'none' | 'pending' | 'ready' | 'error'
    - `summaryError` string, nullable
    - `decisions` string[]
    - `actionItems` MeetingActionItem[]
      - `text` string
      - `ownerHint` string, nullable
      - `status` 'suggested' | 'dismissed' | 'converted'
      - `taskId` string, nullable
    - `actionItemCount` integer
    - `openActionItemCount` integer
    - `sourceUrl` string, nullable
    - `recordingUrl` string, nullable
    - `projectId` string, nullable
    - `projectName` string, nullable
    - `relatedObjects` MeetingRelatedObject[]
      - `kind` 'task' | 'project' | 'product' | 'company' | 'initiative' | 'goal' | 'epic' | 'feature' | 'component' | 'requirement' | 'persona' | 'stakeholder' | 'feedback' | 'idea' | 'deliverable' | 'sprint' | 'iteration' | 'bug' | 'milestone' | 'repo', required
      - `objectId` string, required
      - `title` string, nullable: Resolved title in responses.
      - `globalId` string, nullable
    - `tags` string[]
    - `transcript` string, nullable: Only present on `GET /meetings/{id}?includeTranscript=true`.
    - `createdAt` integer: Epoch ms.
    - `updatedAt` integer, nullable: Epoch ms.

## Other responses

- `401`: Missing or invalid API key (`unauthorized`).
- `404`: Resource not found in this org (`not_found`).

---

[API](https://skmtc.dev/pencil/apis/pencil-public-api.md) · [All operations](https://skmtc.dev/pencil/apis/pencil-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pencil/apis/pencil-public-api/revisions/2b842698b76d?raw)
