> ## 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 speaker profile

> Retrieve a speaker profile with detailed statistics and recent meeting appearances.

Returns the full speaker profile including aggregate statistics such as total speaking time, average words per minute, and a list of recent meeting appearances.

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

### Response

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

<ResponseField name="name" type="string">
  Display name of the speaker.
</ResponseField>

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

<ResponseField name="organization" type="string | null">
  Organization or company name.
</ResponseField>

<ResponseField name="stats" type="object">
  Aggregate statistics for this speaker.

  <Expandable title="Stats object">
    <ResponseField name="meeting_count" type="integer">
      Total number of meetings this speaker has appeared in.
    </ResponseField>

    <ResponseField name="total_speaking_seconds" type="integer">
      Total speaking time across all meetings in seconds.
    </ResponseField>

    <ResponseField name="avg_speaking_seconds_per_meeting" type="number">
      Average speaking time per meeting in seconds.
    </ResponseField>

    <ResponseField name="avg_words_per_minute" type="number">
      Average speaking rate in words per minute.
    </ResponseField>

    <ResponseField name="total_word_count" type="integer">
      Total number of words spoken across all meetings.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="recent_meetings" type="array">
  The 10 most recent meetings where this speaker appeared.

  <Expandable title="Meeting appearance object">
    <ResponseField name="meeting_id" type="string">
      Meeting identifier.
    </ResponseField>

    <ResponseField name="meeting_title" type="string">
      The meeting title.
    </ResponseField>

    <ResponseField name="started_at" type="string">
      ISO 8601 timestamp when the meeting started.
    </ResponseField>

    <ResponseField name="speaking_seconds" type="integer">
      Speaking time in this specific meeting in seconds.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="last_seen_at" type="string">
  ISO 8601 timestamp of the most recent meeting appearance.
</ResponseField>

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

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp when the profile was last updated.
</ResponseField>

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

  ```python Python theme={null}
  profile = client.speaker_profiles.get("spk_a1b2c3d4e5")
  print(f"{profile.name} — {profile.stats.meeting_count} meetings")
  print(f"  Avg speaking rate: {profile.stats.avg_words_per_minute} wpm")
  ```

  ```javascript Node.js theme={null}
  const profile = await client.speakerProfiles.get('spk_a1b2c3d4e5');
  console.log(`${profile.name} — ${profile.stats.meeting_count} meetings`);
  console.log(`  Avg speaking rate: ${profile.stats.avg_words_per_minute} wpm`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "spk_a1b2c3d4e5",
    "name": "Sarah Chen",
    "email": "sarah@example.com",
    "organization": "Acme Corp",
    "stats": {
      "meeting_count": 24,
      "total_speaking_seconds": 18420,
      "avg_speaking_seconds_per_meeting": 767.5,
      "avg_words_per_minute": 142.3,
      "total_word_count": 43668
    },
    "recent_meetings": [
      {
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "meeting_title": "Weekly Product Sync",
        "started_at": "2026-04-10T14:00:00Z",
        "speaking_seconds": 842
      },
      {
        "meeting_id": "mtg_7e2d1c0b9a8g",
        "meeting_title": "Design Review — Onboarding Flow",
        "started_at": "2026-04-08T11:00:00Z",
        "speaking_seconds": 612
      }
    ],
    "last_seen_at": "2026-04-10T14:47:32Z",
    "created_at": "2026-01-15T09:00:00Z",
    "updated_at": "2026-04-10T14:52:08Z"
  }
  ```
</ResponseExample>
