A finished meeting

When a recorded meeting’s results are ready, your user opens it and sees what was said, by whom, and what was decided.

A meeting page with a summary, an action item assigned to Laia, a transcript by speaker and an audio player. Notes: the meeting.finished webhook, then GET /meetings/{id}/results; summary.sections, summary.action_items, transcript.segments with speakers member_id, and media.audio_url.

When the meeting finishes

meeting.finished fires once, when the results are ready or failed. Read them all in one call:

curl "https://api.aefer.ai/api/v1/meetings/mtg_01k6a2r9s8x7c2dvq3m5n6p4ab/results" \
  -H "Authorization: $AEFER_API_KEY" \
  -H "Aefer-Version: 2026-11-13"

{
  "object": "meeting_results",
  "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "status": "ready",
  "transcript": {
    "status": "ready",
    "language": "en",
    "segments": [
      {
        "speaker_id": "spk_1",
        "start_seconds": 0.0,
        "end_seconds": 14.2,
        "text": "Morning all, shall we start with the renewal?"
      },
      {
        "speaker_id": "spk_2",
        "start_seconds": 14.2,
        "end_seconds": 31.8,
        "text": "Yes. We're keen, but pricing needs to move."
      }
    ]
  },
  "speakers": [
    {
      "id": "spk_1",
      "label": "Ana García",
      "name": "Ana García",
      "email": "ana@acme.com",
      "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab",
      "identified": true,
      "talk_time_seconds": 812.4
    },
    {
      "id": "spk_2",
      "label": "Speaker 2",
      "name": null,
      "email": null,
      "member_id": null,
      "identified": false,
      "talk_time_seconds": 640.1
    }
  ],
  "summary": {
    "status": "ready",
    "markdown": "## Renewal\n- Acme wants to renew",
    "sections": [{ "heading": "Renewal", "text": null, "items": ["Acme wants to renew"] }],
    "action_items": [
      {
        "text": "Ana: send revised pricing",
        "assignee": {
          "name": "Ana García",
          "email": "ana@acme.com",
          "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
        }
      }
    ]
  },
  "media": {
    "status": "ready",
    "duration_seconds": 1834.0,
    "audio_url": "https://storage.meetingkit.com/…",
    "video_url": "https://storage.meetingkit.com/…",
    "expires_at": "2026-10-13T10:41:10Z"
  }
}

A meeting has one set of results, however many bots were sent to it.

What each part gives you

Transcript: segments are speaker turns, in order, each pointing at a speaker by speaker_id. Add ?include=words to get word timings in each segment’s words.
Speakers: each is listed once. label is the name _æfer gave the speaker: usually the name the call showed for them, such as their Google Meet display name, or a neutral Speaker 2 when there is none. Renaming a speaker in the transcript changes it. identified is true when _æfer linked the speaker to a person in your workspace, from that name and the meeting’s participants. Then name is set, email when the person has one, and member_id when they are one of your users. When identified is false, all three are null, whatever the label says. spk_ ids are unique within one meeting only.
Summary: markdown is ready to render; sections is the same content as data. action_items are the follow-ups, with an assignee when an item names one known person.
Media: audio_url and video_url are signed links valid until expires_at, one hour. Download what you keep, or read the results again for fresh links. video_url is null for audio-only recordings.

Statuses

The top-level status and each part’s status are one of:

Status	Meaning
`none`	Nothing yet, and it stays `none` when nothing was recorded.
`processing`	Being made.
`ready`	Done.
`failed`	It could not be made.

The transcript is ready before the summary: meeting.updated fires as each part changes, so you can show the transcript first.

Get started

Getting meetings in

Build the screens

A finished meeting

When the meeting finishes

What each part gives you

Statuses