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

# Get Meeting

> 指定したミーティングの詳細情報を取得します。
文字起こしデータは `/v1/meetings/{meetingId}/transcript` を参照してください。
`visibility_scope` が `ATTENDEES_ONLY` のミーティングは、参加者本人であっても 403 を返します。
返却対象は `status = COMPLETED` かつ `visibility_scope = WORKSPACE_ONLY` のミーティングのみです。
サマリーやアクションアイテムの生成状態は `overview_status` で確認できます。




## OpenAPI

````yaml /openapi.yaml get /v1/meetings/{meetingId}
openapi: 3.1.0
info:
  title: Frictio Public API
  version: 1.0.0-beta
servers:
  - url: https://public-api.frictio.ai
security:
  - ApiKeyAuth: []
paths:
  /v1/meetings/{meetingId}:
    get:
      summary: Get Meeting
      description: >
        指定したミーティングの詳細情報を取得します。

        文字起こしデータは `/v1/meetings/{meetingId}/transcript` を参照してください。

        `visibility_scope` が `ATTENDEES_ONLY` のミーティングは、参加者本人であっても 403 を返します。

        返却対象は `status = COMPLETED` かつ `visibility_scope = WORKSPACE_ONLY`
        のミーティングのみです。

        サマリーやアクションアイテムの生成状態は `overview_status` で確認できます。
      operationId: getMeeting
      parameters:
        - $ref: '#/components/parameters/workspaceId'
        - $ref: '#/components/parameters/meetingId'
      responses:
        '200':
          description: 成功
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Meeting'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    workspaceId:
      name: X-Workspace-Id
      in: header
      required: true
      description: ワークスペースID
      schema:
        type: string
      example: e1f2a3b4-...
    meetingId:
      name: meetingId
      in: path
      required: true
      description: ミーティングID
      schema:
        type: string
      example: a1b2c3d4-...
  schemas:
    Meeting:
      allOf:
        - $ref: '#/components/schemas/BaseMeeting'
        - type: object
          required:
            - speakers
            - summaries
            - action_items
          properties:
            speakers:
              type: array
              description: 話者リスト
              items:
                $ref: '#/components/schemas/Speaker'
            summaries:
              type: array
              description: サマリー（チャプター別）
              items:
                $ref: '#/components/schemas/Summary'
            action_items:
              type: array
              description: アクションアイテムリスト
              items:
                $ref: '#/components/schemas/ActionItem'
    BaseMeeting:
      type: object
      description: ミーティングの基本情報
      required:
        - meeting_id
        - frictio_meeting_url
        - workspace_id
        - title
        - platform
        - start_time
        - end_time
        - base_type
        - recording_source
        - overview_status
        - recording_duration
        - crm_type
        - meeting_type_name
        - transcript_config
        - meeting_owner
        - attendees
        - crm_integrations
        - related_objects
      properties:
        meeting_id:
          type: string
          description: ミーティングID
          example: a1b2c3d4-...
        frictio_meeting_url:
          type: string
          format: uri
          description: FrictioミーティングURL
          example: https://app.frictio.ai/ws/e1f2a3b4-.../meetings/1234567890
        workspace_id:
          type: string
          description: ワークスペースID
          example: e1f2a3b4-...
        title:
          type: string
          description: タイトル
          example: PoC実装レビュー - UI & 認証対応
        platform:
          type:
            - string
            - 'null'
          description: プラットフォーム（Zoom, Google Meet等）
          example: Zoom
        start_time:
          type: string
          format: date-time
          description: 開始時間（UTC）
          example: '2026-06-05T10:00:00.000Z'
        end_time:
          type:
            - string
            - 'null'
          format: date-time
          description: 終了時間（UTC）
          example: '2026-06-05T10:30:00.000Z'
        recording_duration:
          type:
            - integer
            - 'null'
          description: 録画・録音時間（秒）
          example: 1800
        base_type:
          type: string
          description: ミーティング種別
          enum:
            - MEETING
            - CALL
          example: MEETING
        recording_source:
          type: string
          description: 録音ソース
          enum:
            - REALTIME_BOT_RECORDING
            - BROWSER_FILE_UPLOAD
            - ZOOM_CALL_FILE_UPLOAD
            - MOBILE_FILE_UPLOAD
            - KCPS_FILE_UPLOAD
          example: REALTIME_BOT_RECORDING
        overview_status:
          type: string
          description: |
            ミーティング概要の生成状態。サマリーやアクションアイテムが揃っているかの判断に使用します。
            - `NOT_STARTED`: ミーティング概要の生成が未開始
            - `IN_PROGRESS`: ミーティング概要の生成中
            - `COMPLETED`: ミーティング概要の生成が完了
            - `NO_TRANSCRIPTION`: 文字起こしデータがなく、ミーティング概要を生成しない
            - `FAILED`: ミーティング概要の生成に失敗
          enum:
            - NOT_STARTED
            - IN_PROGRESS
            - COMPLETED
            - NO_TRANSCRIPTION
            - FAILED
          example: COMPLETED
        crm_type:
          type:
            - string
            - 'null'
          description: CRMタイプ
          enum:
            - HUBSPOT
            - SALESFORCE
          example: HUBSPOT
        meeting_type_name:
          type:
            - string
            - 'null'
          description: ミーティングタイプ名
          example: 商談
        transcript_config:
          oneOf:
            - $ref: '#/components/schemas/TranscriptConfig'
            - type: 'null'
          description: 文字起こし設定
        meeting_owner:
          $ref: '#/components/schemas/MeetingOwner'
        attendees:
          type: array
          description: 参加者リスト
          items:
            $ref: '#/components/schemas/Attendee'
        crm_integrations:
          type: array
          description: CRM連携リスト
          items:
            $ref: '#/components/schemas/CrmIntegration'
        related_objects:
          type: array
          description: |
            リレーションされているFrictioオブジェクト（Contact, Company）。
            ミーティングに紐づくContactやCompanyの情報と、同期先のCRMレコード情報を含みます。
            返却される Contact および Company は `visibility = PUBLIC`（公開）のものに限定されます。
            `visibility = PRIVATE`（非公開）の Contact / Company はクエリパラメータによらず含まれません。
          items:
            $ref: '#/components/schemas/RelatedObject'
    Speaker:
      type: object
      required:
        - speaker_name
        - speaker_ratio
      properties:
        speaker_name:
          type: string
          description: 話者名
          example: Yusuke Ohashi
        speaker_ratio:
          type: number
          format: float
          description: 発話比率（0.0〜1.0）
          example: 0.55
    Summary:
      type: object
      required:
        - chapter_title
        - chapter_items
      properties:
        chapter_title:
          type: string
          description: チャプタータイトル
          example: 課題と対応策
        chapter_items:
          type: array
          items:
            type: object
            required:
              - item
              - time
            properties:
              item:
                type: string
                example: UI修正方針とPoCへの反映について議論
              time:
                type:
                  - integer
                  - 'null'
                description: 開始からの秒数
                example: 10
    ActionItem:
      type: object
      required:
        - id
        - text
        - detail
        - due_date
        - time
        - completed
      properties:
        id:
          type: string
          description: アクションアイテムID
          example: 5d3e2435-07dd-49ed-8e1b-3f469b493c5e
        text:
          type: string
          description: アクションアイテムのタイトル
          example: UI修正とSAML資料のアップデートを次回までに完了する
        detail:
          type:
            - string
            - 'null'
          description: アクションアイテムの詳細
          example: PoCのユーザー登録フローのUI修正、およびSAML認証に関する資料の更新
        due_date:
          type:
            - string
            - 'null'
          format: date
          description: 期限日
          example: '2026-06-12'
        time:
          type:
            - integer
            - 'null'
          description: ミーティング開始からの秒数（アクションアイテムが言及された時点）
          example: 120
        completed:
          type: boolean
          description: アクションアイテムが完了済みかどうか
          example: false
    Error:
      type: object
      required:
        - statusCode
        - message
      properties:
        statusCode:
          type: integer
          description: HTTPステータスコード
          example: 404
        message:
          type: string
          description: エラーメッセージ
          example: Meeting not found
        error:
          type: string
          description: |
            エラー種別。メッセージ文字列付きで例外が生成された場合のみ含まれます。
          example: Not Found
    TranscriptConfig:
      type: object
      required:
        - languages
      properties:
        languages:
          type: array
          description: 文字起こし言語（例：["ja", "en"]）
          items:
            type: string
          example:
            - ja
            - en
    MeetingOwner:
      type: object
      required:
        - name
        - email
        - teams
      properties:
        name:
          type: string
          description: 氏名
          example: 大橋 勇輔
        email:
          type: string
          format: email
          description: メールアドレス
          example: sample@syslea.io
        teams:
          type: array
          description: 所属チームリスト
          items:
            $ref: '#/components/schemas/Team'
    Attendee:
      type: object
      required:
        - attendee_user_name
        - attendee_user_email
        - is_workspace_member
        - is_internal
        - teams
        - contact_id
      properties:
        attendee_user_name:
          type:
            - string
            - 'null'
          description: 表示名。外部参加者の場合、プラットフォームから名前を取得できないケースではnullになります。
          example: 大橋 勇輔
        attendee_user_email:
          type:
            - string
            - 'null'
          format: email
          description: |
            メールアドレス。
            ZOOM_CALL_FILE_UPLOAD（コール）の場合、電話番号に紐づくContactのメールアドレスが設定されます。
            Contactが存在しない場合はnullになります。
          example: sample@syslea.io
        is_workspace_member:
          type: boolean
          description: ワークスペースメンバーフラグ
          example: true
        is_internal:
          type: boolean
          description: 社内メンバーフラグ
          example: true
        teams:
          type: array
          description: 所属チームリスト
          items:
            $ref: '#/components/schemas/Team'
        contact_id:
          type:
            - string
            - 'null'
          description: 紐づくContactのID。詳細はrelated_objectsを参照。
          example: a1b2c3d4-...
    CrmIntegration:
      type: object
      required:
        - record_id
        - record_name
        - record_url
        - record_object_type
      properties:
        record_id:
          type: string
          description: CRMレコードID
          example: '12345678901'
        record_name:
          type: string
          description: CRMレコード名
          example: 株式会社シスリー
        record_url:
          type: string
          format: uri
          description: CRMレコードURL
          example: https://app.hubspot.com/contacts/12345678901
        record_object_type:
          type: string
          description: CRMオブジェクトタイプ
          example: contact
    RelatedObject:
      type: object
      required:
        - display_name
        - object_id
        - object_type
        - fields
        - sync_crm_object
      properties:
        display_name:
          type: string
          description: レコード名
          example: 大橋 勇輔
        object_id:
          type: string
          description: FrictioオブジェクトのレコードID
          example: a1b2c3d4-...
        object_type:
          type: string
          description: Frictioのオブジェクトタイプ
          enum:
            - contact
            - company
          example: contact
        fields:
          type:
            - object
            - 'null'
          description: |
            オブジェクトタイプに応じたフィールドの値。
            contactの場合: company_ids（紐づくCompanyのIDリスト）, is_internal（社内フラグ）など
          example:
            company_ids:
              - c1d2e3f4-...
            is_internal: false
        sync_crm_object:
          oneOf:
            - $ref: '#/components/schemas/SyncCrmObject'
            - type: 'null'
          description: 同期されているCRMオブジェクトレコード。CRM連携がない場合はnull。
    Team:
      type: object
      required:
        - team_id
        - name
      properties:
        team_id:
          type: string
          description: チームID
          example: b2c3d4e5-...
        name:
          type: string
          description: チーム名
          example: 営業チーム
    SyncCrmObject:
      type: object
      description: CRM同期オブジェクト（RelatedObject.sync_crm_object用）
      required:
        - record_id
        - record_name
        - record_url
        - record_object_type
      properties:
        record_id:
          type: string
          description: CRMレコードID
          example: '12345678901'
        record_name:
          type: string
          description: CRMレコード名
          example: 株式会社シスリー
        record_url:
          type: string
          format: uri
          description: CRMレコードURL
          example: https://app.hubspot.com/contacts/12345678901
        record_object_type:
          type: string
          description: CRMオブジェクトタイプ
          example: contact
  responses:
    Unauthorized:
      description: APIキーが無効、失効、期限切れ、または未指定です
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            statusCode: 401
            message: Invalid API key
            error: Unauthorized
    Forbidden:
      description: 権限エラー
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            statusCode: 403
            message: Forbidden
    NotFound:
      description: リソースが見つかりません
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            statusCode: 404
            message: Not Found
    TooManyRequests:
      description: レートリミット超過
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            statusCode: 429
            message: Too Many Requests
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````