---
title: "Get a meeting"
method: GET
path: "/public-api/v1/meetings/{meeting_id}"
tags: ["meetings"]
---

# Get a meeting

`GET /public-api/v1/meetings/{meeting_id}`

## Request

- Base URL: `/` (relative, and the document’s source URL is not known)
- URL: `/public-api/v1/meetings/{meeting_id}`
- Auth: HTTP bearer and API key in header `x-tenant-code`

Retrieve one video meeting record, wrapped as ``{"video": {...}}``.

Returns the video's declared fields plus the derived ``status``,
``participant_count``, and ``tags``. Returns 404 when the id is unknown in the
caller's tenant, and 422 for a malformed id (at request validation).

## Path parameters

- `meeting_id` string, uuid, required

## Response `200`

The requested meeting and its derived metadata.

- VideoRetrieveResponse: Response for ``GET /meetings/{id}``: the ``{"video": {...}}`` envelope.
  - `video` VideoRecord, required: One video, with its recordings, participants, chat, analysis and summaries. Only the fields declared here are returned; nothing else surfaces.
    - `title` string, nullable
    - `platform` string, nullable
    - `starts_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `duration` union
      - integer
      - number
    - `access_permission` string, nullable
    - `bookmarked` boolean, nullable
    - `participant_names` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `video_participants` VideoRecordParticipant[], nullable
      - `id` string, nullable
      - `user_name` string, nullable
      - `user_name_at_creation` string, nullable
      - `guest_id` string, nullable
    - `video_details` VideoDetail[], nullable
      - `id` string, nullable
      - `starts_at` string, date-time, nullable
      - `ends_at` string, date-time, nullable
      - `volumes` number[], nullable
      - `state_video` string, nullable
      - `state_audio` string, nullable
      - `state_audio_analyze_error_reason` string, nullable
      - `video_keywords` VideoKeyword[], nullable
        - `id` string, nullable
        - `keyword` string, nullable
        - `starts_at` number, nullable
        - `video_participant` VideoRecordParticipant: A meeting participant.
          - `id` string, nullable
          - `user_name` string, nullable
          - `user_name_at_creation` string, nullable
          - `guest_id` string, nullable
        - `video_tags` VideoKeywordTag[], nullable
          - `id` string, uuid, nullable
          - `value` string, nullable
          - `creator_type` string, nullable
      - `video_participant_analysis` VideoParticipantAnalysis[], nullable
        - `video_participant` VideoRecordParticipant: A meeting participant.
          - `id` string, nullable
          - `user_name` string, nullable
          - `user_name_at_creation` string, nullable
          - `guest_id` string, nullable
        - `volumes` number[], nullable
        - `f0` number, nullable
        - `speechrate` number, nullable
        - `variance` number, nullable
        - `tlr` number, nullable
        - `speak` VideoAnalysisSpan[], nullable
          - `start_at` number, nullable
          - `end_at` number, nullable
        - `silence_all` VideoSilenceAll: Aggregated silence stats.
          - `count` integer, nullable
          - `position` VideoAnalysisSpan[], nullable
            - `start_at` number, nullable
            - `end_at` number, nullable
        - `overlap` VideoAnalysisSpan[], nullable
          - `start_at` number, nullable
          - `end_at` number, nullable
        - `overlap_all` VideoOverlapAll: Aggregated overlapping-speech stats.
          - `count` integer, nullable
        - `filler_count` integer, nullable
      - `video_detail_participants` VideoDetailParticipant[], nullable
        - `id` string, nullable
        - `analysis_status` string, nullable
        - `guest_id` string, nullable
        - `video_participant_id` string, nullable
      - `video_summaries` VideoRecordSummary[], nullable
        - `id` string, uuid, nullable
        - `summary` string, nullable
        - `summary_status` string, nullable
        - `submitted_prompt_template_id` string, nullable
        - `requested_by` VideoSummaryRequester: The account that requested the summary.
          - `account_id` string, nullable
          - `name` string, nullable
        - `requester_type` string, nullable
        - `is_edited` boolean, nullable
        - `created_at` string, date-time, nullable
        - `is_quick_summary` boolean, nullable
        - `redacted_due_to_copyright_on_creation` boolean, nullable
    - `video_chats` VideoChat[], nullable
      - `id` string, nullable
      - `user_name` string, nullable
      - `posts_at` string, date-time, nullable
      - `text` string, nullable
      - `video_participant` VideoRecordParticipant: A meeting participant.
        - `id` string, nullable
        - `user_name` string, nullable
        - `user_name_at_creation` string, nullable
        - `guest_id` string, nullable
      - `element` VideoChatElement: Structured content of a chat message.
        - `urls` VideoChatUrl[], nullable
          - `url` string, nullable
          - `indices` integer[], nullable
    - `salesforce_event_id` string, nullable
    - `salesforce_id` string, nullable
    - `access_users` VideoAccessUser[], nullable
      - `account_id` string, uuid, required
      - `name` string, nullable
      - `deleted` boolean, nullable
    - `host` VideoAccountUser: An account user reference.
      - `id` string, uuid, nullable
      - `name` string, nullable
    - `sound_source` string, nullable
    - `folder_id` string, uuid, nullable
    - `third_party_last_synced_at` string, date-time, nullable
    - `quick_transcript_completion_time` string, date-time, nullable
    - `high_precision_transcript_completion_time` string, date-time, nullable
    - `bot_id` string, nullable
    - `metadata` object, nullable
    - `summaries_count` integer, nullable
    - `summary_quota` integer, nullable
    - `summary_quota_usage` integer, nullable
    - `play_users` VideoUserRef[], nullable
      - `id` integer, nullable
      - `first_name` string, nullable
    - `play_users_count` integer, nullable
    - `id` string, uuid, required
    - `status` string, nullable
    - `participant_count` integer, nullable
    - `tags` VideoKeywordTag[]
      - `id` string, uuid, nullable
      - `value` string, nullable
      - `creator_type` string, nullable

## Other responses

- `400`: The tenant could not be resolved from the request.
- `401`: Error envelope (`public_api.unauthorized`).
- `403`: The request is not allowed for the current tenant or access configuration.
- `404`: Error envelope (`public_api.not_found`).
- `409`: Error envelope (`public_api.conflict`).
- `413`: The request body exceeds the maximum allowed size.
- `422`: Validation Error
- `429`: Rate limit exceeded. Wait for ``Retry-After`` seconds before retrying.
- `502`: Error envelope (`public_api.internal_error`).
- `503`: The request could not be served right now. Please retry.
- `504`: Error envelope (`public_api.request_timeout`).

---

[API](https://skmtc.dev/miitel/apis/miitel-public-api.md) - [All operations](https://skmtc.dev/miitel/apis/miitel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miitel/apis/miitel-public-api/revisions/961732756fa3?raw)