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

# get meeting invite

> Get a meeting invite by ID for the authenticated organization.



## OpenAPI

````yaml https://api.anam.ai/swagger.json get /v1/meetings/invites/{id}
openapi: 3.1.0
info:
  title: Anam AI API
  version: '1.0'
servers:
  - url: https://api.anam.ai
    description: Anam API
security:
  - BearerAuth: []
tags:
  - name: Sessions
  - name: Meetings
  - name: Personas
  - name: Avatars
  - name: Voices
  - name: LLMs
  - name: Knowledge
  - name: Tools
  - name: Share Links
  - name: Engine
paths:
  /v1/meetings/invites/{id}:
    get:
      tags:
        - Meetings
      summary: Get meeting invite
      description: Get a meeting invite by ID for the authenticated organization.
      operationId: getMeetingInvite
      parameters:
        - in: path
          name: id
          required: true
          description: Meeting invite ID.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successfully retrieved meeting invite
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingInvite'
              examples:
                default:
                  $ref: '#/components/examples/MeetingInviteResponse'
        '401':
          description: Unauthorized - missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingInviteError'
              examples:
                missingKey:
                  value:
                    error: Missing or invalid API key
                invalidKey:
                  value:
                    error: Invalid API key
        '403':
          description: Forbidden - API key lacks the required permission.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingInviteError'
              examples:
                forbidden:
                  value:
                    error: Forbidden
        '404':
          description: Not Found - meeting invite was not found in the organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingInviteError'
              examples:
                notFound:
                  value:
                    error: Not found
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingInviteError'
              examples:
                serverError:
                  value:
                    error: Failed to process meeting invite
components:
  schemas:
    MeetingInvite:
      type: object
      description: A meeting invite created for a persona.
      required:
        - id
        - provider
        - meetingUrl
        - displayName
        - status
        - createdAt
        - joinAt
        - groupCall
        - sessionId
        - region
        - joinState
        - statusReason
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the meeting invite.
        provider:
          type: string
          enum:
            - google_meet
            - zoom
            - microsoft_teams
          description: Meeting provider inferred from the meeting URL.
        meetingUrl:
          type: string
          format: uri
          description: Normalized meeting URL.
        displayName:
          type: string
          description: Display name used in the meeting.
        status:
          type: string
          enum:
            - pending
            - active
            - cancelled
            - ended
            - failed
          description: Current invite status.
        createdAt:
          type: string
          format: date-time
          description: Time the invite was created.
        joinAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Scheduled time the persona joins the meeting, or null when the
            persona was asked to join immediately.
        groupCall:
          type: boolean
          description: >-
            Whether group-call turn-taking is enabled for this invite (respond
            only when addressed by name; silent join).
        sessionId:
          type:
            - string
            - 'null'
          description: >-
            Engine session ID once the meeting session has started, otherwise
            null.
        region:
          type:
            - string
            - 'null'
          enum:
            - eu
            - us-east
            - us-west
            - null
          description: >-
            Region the persona joined the call from. May differ from the
            requested region when the invite was served by another region for
            availability. Additional region values may be introduced over time;
            treat unrecognized values as informational rather than an error.
        joinState:
          type:
            - string
            - 'null'
          enum:
            - joining
            - waiting_room
            - in_call
            - media_denied
            - media_granted
            - media_active
            - left
            - done
            - error
            - null
          description: >-
            Latest observed call-participation detail for the persona, updated
            asynchronously as the persona connects, waits for admission, joins,
            and leaves. Null until the first update arrives. Values may be added
            over time; treat unrecognized values as informational.
        statusReason:
          type:
            - string
            - 'null'
          description: >-
            Reason attached to a terminal participation state — for example
            `removed_by_host`, `meeting_ended`, `not_admitted`, `join_denied`,
            `meeting_link_invalid`, `meeting_not_started`, `idle_timeout`,
            `left_call`, or `provider_error`. Null while the invite is in
            progress. Values may be added over time; treat unrecognized values
            as informational.
    MeetingInviteError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  examples:
    MeetingInviteResponse:
      summary: A meeting invite resource
      value:
        id: 00000000-0000-0000-0000-000000000000
        provider: google_meet
        meetingUrl: https://meet.google.com/abc-defg-hij
        displayName: Cara (AI)
        status: pending
        createdAt: '2026-04-20T10:00:00.000Z'
        joinAt: null
        groupCall: true
        sessionId: null
        region: eu
        joinState: null
        statusReason: null
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````