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

# Get meeting

> Get detailed information about a specific meeting, including tasks, decisions, transcript summary, and analysis status.



## OpenAPI

````yaml /openapi.json get /meetings/{id}
openapi: 3.0.3
info:
  title: Mavera API
  version: 1.0.0
  description: >-
    # Getting Started


    The Mavera Responses API provides persona-powered AI responses using the
    **OpenAI Responses API format**. Use `client.responses.create()` with the
    OpenAI SDK — just set the base URL to `https://app.mavera.io/api/v1`.


    ## Authentication


    All API requests require a Bearer token. Create an API key in **Settings >
    Developer > API Keys**.


    ```

    Authorization: Bearer mvra_live_your_key_here

    ```


    ## Quick Start


    ### Step 1: Get a Persona ID


    Every response request requires a `persona_id`. First, list available
    personas:


    ```bash

    curl https://app.mavera.io/api/v1/personas \
      -H "Authorization: Bearer mvra_live_your_key_here"
    ```


    This returns personas you can use. Copy the `id` field from any persona.


    ### Step 2: Create a Response


    Use the persona ID in your request:


    ```bash

    curl https://app.mavera.io/api/v1/responses \
      -H "Authorization: Bearer mvra_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "mavera-1",
        "persona_id": "YOUR_PERSONA_ID",
        "input": "Hello!"
      }'
    ```


    ## Rate Limits


    Per-key sliding window limits based on your subscription tier:


    | Tier | Requests / min |

    |------|---------------|

    | Starter | 60 |

    | Basic | 120 |

    | Professional | 240 |

    | Enterprise | 600 |


    When rate limited, the response includes a `Retry-After` header indicating
    how many seconds to wait.


    ## Credits


    Each API call consumes credits from your subscription. The
    `usage.credits_used` field in the response shows the cost of each request.
  contact:
    name: Mavera Support
    url: https://mavera.io
  x-logo:
    url: /Mavera_Logo_Full.png
    altText: Mavera
servers:
  - url: https://app.mavera.io/api/v1
    description: Production
  - url: https://dev.mavera.io/api/v1
    description: Development
security:
  - BearerAuth: []
tags:
  - name: System
    description: Health checks and operational status.
  - name: Responses
    description: >-
      Generate persona-powered AI responses using the OpenAI Responses API
      format. Use `client.responses.create()` with the OpenAI SDK.
  - name: Models
    description: Discover available models and their capabilities.
  - name: Personas
    description: >-
      Browse available personas to inject specialized intelligence into
      responses via `persona_id`.
  - name: Custom Personas
    description: >-
      Create, manage, and customize AI-powered personas. Supports three creation
      pipelines: North Star (AI-generated from minimal input), Intermediate
      (guided 3-step process), and Advanced (full B2B/B2C customization with
      psychographics and purpose packs). 300 credits per persona.
  - name: Brand Voice
    description: >-
      Create, manage, and retrieve brand voice profiles for AI-powered content
      generation. Upload URLs and documents to analyze, and the AI will generate
      tone guidelines, vocabulary preferences, and writing style
      recommendations.
  - name: Generations
    description: >-
      Generate AI-powered content using pre-built templates with optional brand
      voice styling. Browse available generation apps, create content, and
      manage your generation history. Supports streaming responses.
  - name: Mave
    description: >-
      Mave is Mavera's AI-powered research and analysis agent. Send messages to
      conduct comprehensive investigations using multiple data sources,
      personas, and fact-checking. Mave uses a multi-phase orchestration process
      (Triage, Planning, Research, Execution, Validation) to deliver
      well-researched responses with sources.
  - name: Workspaces
    description: >-
      Manage workspaces for organizing your work. Workspaces contain projects,
      threads, personas, and other resources. Invite team members with
      role-based access control. Set budget alerts and usage limits.
  - name: Projects
    description: >-
      Organize work within workspaces using projects. Projects contain threads,
      generations, and other resources. Track usage and set per-project budget
      controls.
  - name: Meetings
    description: >-
      Access meeting recordings, transcripts, and AI-powered analysis. List
      meetings, retrieve transcripts in multiple formats (segments, text, SRT),
      get AI analysis with summaries, tasks, decisions, highlights, and coaching
      metrics. Run custom schemas to extract structured data from transcripts.
  - name: Schemas
    description: >-
      Create and manage meeting schemas for structured data extraction. Schemas
      define fields to extract from meeting transcripts, with support for
      various field types (text, enum, list, boolean, etc.), evidence tracking,
      and scoring.
  - name: Files
    description: >-
      Upload, manage, and retrieve files/assets. Use presigned URLs for direct
      uploads to avoid passing files through the API. Supports images, videos,
      documents, and more. File uploads count against your storage quota.
  - name: Folders
    description: >-
      Create and manage folders to organize your files. Folders can be favorited
      and shared with workspace members.
  - name: Video Analysis
    description: >-
      AI-powered video and advertisement analysis. Submit videos for
      comprehensive emotional, cognitive, behavioral, and technical analysis.
      Chat with AI about the results.
  - name: Focus Groups
    description: >-
      AI-powered synthetic focus group research. Create focus groups with
      personas to gather market research, product feedback, and audience
      insights. Supports 12 question types including NPS, Likert scales, and
      open-ended responses.
  - name: News
    description: >-
      AI-powered news intelligence. Browse trending stories, get AI analysis
      from persona perspectives, and manage scheduled news digests. Story
      analysis uses credits based on token usage.
  - name: Usage
    description: >-
      Monitor your subscription usage including credits, transcription minutes,
      storage, and API request metrics. Get real-time statistics on your billing
      period usage.
paths:
  /meetings/{id}:
    get:
      tags:
        - Meetings
      summary: Get meeting
      description: >-
        Get detailed information about a specific meeting, including tasks,
        decisions, transcript summary, and analysis status.
      operationId: getMeeting
      parameters:
        - name: id
          in: path
          required: true
          description: Meeting ID
          schema:
            type: string
      responses:
        '200':
          description: Meeting details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Meeting'
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Meeting not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Meeting:
      type: object
      properties:
        id:
          type: string
          description: Unique meeting identifier
        object:
          type: string
          enum:
            - meeting
        title:
          type: string
          nullable: true
          description: Meeting title
        meeting_url:
          type: string
          description: Original meeting URL
        bot_name:
          type: string
          description: Name of the recording bot
        join_type:
          type: string
          nullable: true
          description: How the bot joined (scheduled, adhoc)
        join_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
        status:
          $ref: '#/components/schemas/MeetingStatus'
        workspace_id:
          type: string
        recording_url:
          type: string
          nullable: true
          description: URL to download the meeting recording (when available)
        cancelled_at:
          type: string
          format: date-time
          nullable: true
          description: When the meeting was cancelled (if cancelled)
        cancelled_by:
          type: string
          nullable: true
          description: User ID who cancelled the meeting
        cancel_reason:
          type: string
          nullable: true
          description: Reason for cancellation
        participants:
          type: array
          items:
            $ref: '#/components/schemas/MeetingParticipant'
          description: List of meeting participants
        participant_count:
          type: integer
        transcript:
          allOf:
            - $ref: '#/components/schemas/MeetingTranscriptSummary'
          nullable: true
          description: Transcript summary if available
        has_transcript:
          type: boolean
        analysis:
          allOf:
            - $ref: '#/components/schemas/MeetingAnalysisSummary'
          nullable: true
          description: Analysis summary if available
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/MeetingTask'
          description: Tasks extracted from the meeting
        task_count:
          type: integer
        decisions:
          type: array
          items:
            $ref: '#/components/schemas/MeetingDecision'
          description: Decisions made during the meeting
        decision_count:
          type: integer
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    ErrorResponse:
      type: object
      description: >-
        All error responses follow this format. The `type` field indicates the
        category of error, and `code` provides a machine-readable error code.
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: A human-readable error message.
              example: Invalid API key.
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - insufficient_credits
                - not_found
                - rate_limit_error
                - api_error
              description: The category of error.
              example: authentication_error
            code:
              type: string
              description: A machine-readable error code.
              example: invalid_api_key
            param:
              type: string
              nullable: true
              description: The request parameter that caused the error, if applicable.
              example: null
      example:
        error:
          message: Invalid API key.
          type: authentication_error
          code: invalid_api_key
          param: null
    MeetingStatus:
      type: string
      enum:
        - pending
        - joining_call
        - in_waiting_room
        - in_call_not_recording
        - in_call_recording
        - call_ended
        - recording_done
        - done
        - fatal
        - recording_permission_denied
        - media_expired
        - cancelled
      description: Current status of the meeting recording
    MeetingParticipant:
      type: object
      properties:
        name:
          type: string
          nullable: true
        email:
          type: string
          nullable: true
        role:
          type: string
          nullable: true
    MeetingTranscriptSummary:
      type: object
      properties:
        duration_seconds:
          type: number
          nullable: true
        total_words:
          type: integer
          nullable: true
        participant_stats:
          type: object
          additionalProperties: true
          nullable: true
    MeetingAnalysisSummary:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        version:
          type: integer
        processing_time_ms:
          type: integer
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    MeetingTask:
      type: object
      properties:
        id:
          type: string
        content:
          type: string
        owner:
          type: string
          nullable: true
        owner_email:
          type: string
          nullable: true
        priority:
          type: string
          nullable: true
          enum:
            - low
            - medium
            - high
            - urgent
        status:
          type: string
          nullable: true
          enum:
            - pending
            - in_progress
            - completed
        due_date:
          type: string
          format: date-time
          nullable: true
        due_date_confidence:
          type: number
          nullable: true
        category:
          type: string
          nullable: true
        evidence_spans:
          type: array
          nullable: true
          items:
            type: object
        created_at:
          type: string
          format: date-time
    MeetingDecision:
      type: object
      properties:
        id:
          type: string
        statement:
          type: string
        owner:
          type: string
          nullable: true
        status:
          type: string
          nullable: true
        deadline:
          type: string
          format: date-time
          nullable: true
        evidence_spans:
          type: array
          nullable: true
          items:
            type: object
        created_at:
          type: string
          format: date-time
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key prefixed with `mvra_live_`. Create keys at **Settings >
        Developer > API Keys**.

````