> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get summary

> Retrieve the AI-generated summary for a meeting, including attendees, decisions, action items, and key points.

Returns a structured summary for a given summary ID. Summaries are automatically generated once a meeting's transcript is ready and include an overview, attendees, agenda items, key decisions, action items, and key discussion points.

<ParamField path="id" type="string" required>
  The unique summary identifier (e.g., `sum_1g2h3i4j5k6l`).
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique summary identifier.
</ResponseField>

<ResponseField name="meeting_id" type="string">
  The ID of the meeting this summary belongs to.
</ResponseField>

<ResponseField name="transcript_id" type="string">
  The ID of the transcript used to generate this summary.
</ResponseField>

<ResponseField name="format" type="string">
  The summary format: `structured` (default), `narrative`, or `bullet_points`.
</ResponseField>

<ResponseField name="language" type="string">
  Language of the summary (ISO 639-1 code).
</ResponseField>

<ResponseField name="overview" type="string">
  A 2-3 sentence high-level overview of the meeting.
</ResponseField>

<ResponseField name="attendees" type="array">
  List of meeting attendees.

  <Expandable title="Attendee object">
    <ResponseField name="name" type="string">
      Attendee display name.
    </ResponseField>

    <ResponseField name="email" type="string | null">
      Attendee email if available.
    </ResponseField>

    <ResponseField name="role" type="string">
      Role in the meeting: `host`, `co_host`, or `attendee`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="agenda" type="array">
  Topics discussed during the meeting.

  <Expandable title="Agenda item object">
    <ResponseField name="title" type="string">
      The topic or agenda item title.
    </ResponseField>

    <ResponseField name="summary" type="string">
      Brief summary of what was discussed under this topic.
    </ResponseField>

    <ResponseField name="duration_seconds" type="integer">
      Approximate time spent discussing this topic.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="decisions" type="array">
  Key decisions made during the meeting.

  <Expandable title="Decision object">
    <ResponseField name="description" type="string">
      A clear description of the decision.
    </ResponseField>

    <ResponseField name="decided_by" type="string">
      Name of the person who made or announced the decision.
    </ResponseField>

    <ResponseField name="context" type="string">
      Brief context on why this decision was made.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="action_items" type="array">
  Action items extracted from the meeting.

  <Expandable title="Action item object">
    <ResponseField name="id" type="string">
      Action item identifier (e.g., `act_m1n2o3`).
    </ResponseField>

    <ResponseField name="title" type="string">
      Short description of the action item.
    </ResponseField>

    <ResponseField name="assignee" type="string | null">
      Name of the person assigned. `null` if unassigned.
    </ResponseField>

    <ResponseField name="due_date" type="string | null">
      Due date if mentioned (ISO 8601 date).
    </ResponseField>

    <ResponseField name="priority" type="string">
      Priority level: `high`, `medium`, or `low`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `pending`, `in_progress`, or `completed`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="key_points" type="array">
  Important discussion points and takeaways (array of strings).
</ResponseField>

<ResponseField name="sentiment" type="string">
  Overall meeting sentiment: `positive`, `neutral`, or `negative`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the summary was generated.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp when the summary was last updated (e.g., after regeneration).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.mavioapp.com/v1/summaries/sum_1g2h3i4j5k6l \
    -H "Authorization: Bearer mvo_live_abc123"
  ```

  ```python Python theme={null}
  summary = client.summaries.get("sum_1g2h3i4j5k6l")
  print(summary.overview)
  for item in summary.action_items:
      print(f"  [{item.priority}] {item.title} → {item.assignee}")
  ```

  ```javascript Node.js theme={null}
  const summary = await client.summaries.get('sum_1g2h3i4j5k6l');
  console.log(summary.overview);
  summary.action_items.forEach(item => {
    console.log(`  [${item.priority}] ${item.title} → ${item.assignee}`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "sum_1g2h3i4j5k6l",
    "meeting_id": "mtg_8f3k2j1m4n5p",
    "transcript_id": "trs_9a2b3c4d5e6f",
    "format": "structured",
    "language": "en",
    "overview": "The product team reviewed the April 20th launch timeline, confirmed Stripe integration is unblocked, and triaged 3 remaining QA bugs. Sprint 14 planning was deferred to a follow-up session.",
    "attendees": [
      { "name": "Sarah Chen", "email": "sarah@example.com", "role": "host" },
      { "name": "James Rodriguez", "email": "james@example.com", "role": "attendee" },
      { "name": "Priya Patel", "email": "priya@example.com", "role": "attendee" },
      { "name": "Marcus Kim", "email": "marcus@example.com", "role": "attendee" },
      { "name": "Aisha Johnson", "email": "aisha@example.com", "role": "attendee" },
      { "name": "Tom Baker", "email": "tom@example.com", "role": "attendee" }
    ],
    "agenda": [
      {
        "title": "Launch timeline update",
        "summary": "Team confirmed April 20th launch date. Stripe sandbox credentials received, integration testing expected complete by April 11th.",
        "duration_seconds": 720
      },
      {
        "title": "QA bug triage",
        "summary": "Reviewed 3 open P1 bugs. Two assigned to James, one to Priya. All must be resolved before launch.",
        "duration_seconds": 1080
      },
      {
        "title": "Sprint 14 planning",
        "summary": "Deferred to a dedicated session on Friday due to time constraints.",
        "duration_seconds": 480
      }
    ],
    "decisions": [
      {
        "description": "Launch date remains April 20th with no delay.",
        "decided_by": "Sarah Chen",
        "context": "Stripe credentials received, removing the last blocker. All P1 bugs are fixable within the timeline."
      },
      {
        "description": "Sprint 14 planning moved to Friday standup.",
        "decided_by": "Sarah Chen",
        "context": "Not enough time remaining in this meeting to cover sprint planning properly."
      }
    ],
    "action_items": [
      {
        "id": "act_p6q7r8",
        "title": "Complete Stripe payment integration testing",
        "assignee": "Priya Patel",
        "due_date": "2026-04-11",
        "priority": "high",
        "status": "pending"
      },
      {
        "id": "act_s9t0u1",
        "title": "Fix checkout page crash on Safari (BUG-442)",
        "assignee": "James Rodriguez",
        "due_date": "2026-04-14",
        "priority": "high",
        "status": "pending"
      },
      {
        "id": "act_v2w3x4",
        "title": "Fix email notification delay (BUG-445)",
        "assignee": "James Rodriguez",
        "due_date": "2026-04-14",
        "priority": "high",
        "status": "pending"
      },
      {
        "id": "act_y5z6a7",
        "title": "Prepare sprint 14 backlog for Friday planning",
        "assignee": "Sarah Chen",
        "due_date": "2026-04-12",
        "priority": "medium",
        "status": "pending"
      }
    ],
    "key_points": [
      "April 20th launch date is confirmed with no blockers remaining.",
      "Stripe sandbox credentials were received on the morning of April 10th.",
      "Three P1 bugs must be resolved before launch: BUG-442, BUG-443, BUG-445.",
      "Sprint 14 planning will happen Friday to allow full focus on launch prep this week."
    ],
    "sentiment": "positive",
    "created_at": "2026-04-10T14:51:44Z",
    "updated_at": "2026-04-10T14:51:44Z"
  }
  ```
</ResponseExample>