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

# Get a meeting

> Get one meeting with its published summary, linked calendar event and attendees.

The same visibility rules as the list endpoint apply. Meetings that do not exist and meetings the organization
cannot see both return 404.



## OpenAPI

````yaml /openapi.json get /public/v1/admin/meetings/{meeting_id}
openapi: 3.1.0
info:
  description: >-
    Read your organization's Wispr Flow data. Authenticate every request with an
    organization API key (`sk_...`) as a Bearer token; each endpoint requires a
    specific permission on the key. Rate limits apply per organization and are
    shared by all of its keys. List endpoints use cursor pagination and return
    results newest first. Only meetings opted in to organization insights are
    visible.
  title: Wispr Flow Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.wisprflow.ai
security:
  - bearerAuth: []
paths:
  /public/v1/admin/meetings/{meeting_id}:
    get:
      tags:
        - Meetings
      summary: Get a meeting
      description: >-
        Get one meeting with its published summary, linked calendar event and
        attendees.


        The same visibility rules as the list endpoint apply. Meetings that do
        not exist and meetings the organization

        cannot see both return 404.
      operationId: getMeeting
      parameters:
        - description: The meeting `id` returned by the list endpoint.
          in: path
          name: meeting_id
          required: true
          schema:
            description: The meeting `id` returned by the list endpoint.
            title: Meeting Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingDetail'
          description: The meeting.
        '401':
          content:
            application/json:
              examples:
                Invalid API key:
                  value:
                    detail: Invalid API key
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: >-
            The API key is missing, malformed, invalid, expired or revoked, or
            the organization's API access is not enabled.
          headers:
            WWW-Authenticate:
              description: Always `Bearer`.
              schema:
                type: string
        '403':
          content:
            application/json:
              examples:
                Permission denied:
                  value:
                    detail: Permission denied
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: The API key does not have the permission this endpoint requires.
        '404':
          content:
            application/json:
              examples:
                Meeting does not exist:
                  value:
                    detail: Meeting not found
                Meeting not visible to the organization:
                  value:
                    detail: Meeting not found
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: >-
            The meeting does not exist or is not visible to the organization.
            Both return the same response.
        '408':
          content:
            application/json:
              examples:
                Request timed out:
                  value:
                    detail: Request timed out
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: The request did not complete within the server's request deadline.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
        '429':
          content:
            application/json:
              examples:
                Rate limit exceeded:
                  value:
                    detail: Rate limit exceeded
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: >-
            The organization's rate limit is exhausted. The limit is shared by
            all of the organization's API keys.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                minimum: 1
                type: integer
        '503':
          content:
            application/json:
              examples:
                Service unavailable:
                  value:
                    detail: Service unavailable
              schema:
                $ref: '#/components/schemas/ErrorDetail'
          description: A dependency is temporarily unavailable. Retry with backoff.
components:
  schemas:
    MeetingDetail:
      description: >-
        Meeting metadata plus the published summary, linked calendar event and
        attendees.
      properties:
        attendees:
          description: >-
            People whose voices were matched in the recording; empty until the
            meeting has been processed or when no voice is matched. Only
            calendar-provided names and emails are included.
          items:
            $ref: '#/components/schemas/MeetingPerson'
          title: Attendees
          type: array
        calendar_event:
          anyOf:
            - $ref: '#/components/schemas/MeetingCalendarEvent'
            - type: 'null'
          description: >-
            The calendar event linked to the recording, or null if none is
            linked.
        created_at:
          description: When the meeting was created, in UTC.
          format: date-time
          title: Created At
          type: string
        id:
          description: The meeting ID.
          format: uuid
          title: Id
          type: string
        owner:
          $ref: '#/components/schemas/MeetingOwner'
        summary_markdown:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The published meeting summary in Markdown, or null if there is none
            yet.
          title: Summary Markdown
        title:
          anyOf:
            - type: string
            - type: 'null'
          description: Meeting title, or null if it has none.
          title: Title
        updated_at:
          description: When the meeting was last updated, in UTC.
          format: date-time
          title: Updated At
          type: string
      required:
        - id
        - title
        - owner
        - created_at
        - updated_at
        - summary_markdown
        - calendar_event
        - attendees
      title: MeetingDetail
      type: object
    ErrorDetail:
      description: Error body returned for every non-validation error.
      properties:
        detail:
          description: Human-readable error message.
          title: Detail
          type: string
      required:
        - detail
      title: ErrorDetail
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    MeetingPerson:
      description: A calendar invitee or attendee; either field may be unknown.
      properties:
        email:
          anyOf:
            - type: string
            - type: 'null'
          description: Email address from the calendar, or null if unknown.
          title: Email
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: Display name from the calendar, or null if unknown.
          title: Name
      required:
        - name
        - email
      title: MeetingPerson
      type: object
    MeetingCalendarEvent:
      description: The owner's calendar event linked to the recording.
      properties:
        id:
          description: >-
            Wispr Flow's identifier for the event. This is not the calendar
            provider's ID.
          title: Id
          type: string
        invitees:
          description: Everyone invited to the event, organizer first.
          items:
            $ref: '#/components/schemas/MeetingPerson'
          title: Invitees
          type: array
        scheduled_end_time:
          description: Scheduled end time, in UTC.
          format: date-time
          title: Scheduled End Time
          type: string
        scheduled_start_time:
          description: Scheduled start time, in UTC.
          format: date-time
          title: Scheduled Start Time
          type: string
        title:
          anyOf:
            - type: string
            - type: 'null'
          description: Event title, or null if it has none.
          title: Title
      required:
        - id
        - title
        - scheduled_start_time
        - scheduled_end_time
        - invitees
      title: MeetingCalendarEvent
      type: object
    MeetingOwner:
      description: The Flow user who recorded the meeting.
      properties:
        email:
          anyOf:
            - type: string
            - type: 'null'
          description: The owner's account email, or null if unknown.
          title: Email
        id:
          description: The owner's Flow user ID. Accepted by the `owner_id` list filter.
          title: Id
          type: string
      required:
        - id
        - email
      title: MeetingOwner
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearerAuth:
      description: >-
        A WorkOS-issued organization API key (`sk_...`) with the
        `admin:meetings:read` permission.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.