> ## 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. # List Playbook Results > 指定したPlaybookの実行結果をミーティング単位で一覧取得します。 同一ミーティング内で同じPlaybookの複数バージョンが存在する場合は、最新の1件のみを返します。 最新判定は `playbook_version` の降順を優先し、同一バージョン内では作成日時とIDの降順で決定されます。 返却対象はワークスペース公開かつ完了済みで、`meeting_start_time` があるミーティングです。 `meeting_start_time` が null のミーティングは返却対象外です。 `from` / `to` は `meeting_start_time` に適用され、`from <= meeting_start_time < to` で絞り込みます。 `from` 未指定時は `to` の1か月前、`to` 未指定時は現在時刻が frictio-server 側で適用されます。 cursor 利用中に sort または filter 条件を変更した場合は 400 を返します。 将来、ロールスコープ連動アクセスが導入された際には、API バージョンを変えず追加的（additive）に返却範囲が拡張される可能性があります。 ## OpenAPI ````yaml /openapi.yaml get /v1/playbooks/{playbookId}/results 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/playbooks/{playbookId}/results: get: summary: List Playbook Results description: > 指定したPlaybookの実行結果をミーティング単位で一覧取得します。 同一ミーティング内で同じPlaybookの複数バージョンが存在する場合は、最新の1件のみを返します。 最新判定は `playbook_version` の降順を優先し、同一バージョン内では作成日時とIDの降順で決定されます。 返却対象はワークスペース公開かつ完了済みで、`meeting_start_time` があるミーティングです。 `meeting_start_time` が null のミーティングは返却対象外です。 `from` / `to` は `meeting_start_time` に適用され、`from <= meeting_start_time < to` で絞り込みます。 `from` 未指定時は `to` の1か月前、`to` 未指定時は現在時刻が frictio-server 側で適用されます。 cursor 利用中に sort または filter 条件を変更した場合は 400 を返します。 将来、ロールスコープ連動アクセスが導入された際には、API バージョンを変えず追加的（additive）に返却範囲が拡張される可能性があります。 operationId: listPlaybookResults parameters: - $ref: '#/components/parameters/workspaceId' - $ref: '#/components/parameters/playbookId' - name: from in: query required: false description: | `meeting_start_time` の開始日時（以上）。ISO 8601 形式で指定してください。 toと組み合わせて期間指定が可能です。 schema: type: string format: date-time example: '2026-02-01T00:00:00.000Z' - name: to in: query required: false description: | `meeting_start_time` の終了日時（未満）。ISO 8601 形式で指定してください。 schema: type: string format: date-time example: '2026-03-01T00:00:00.000Z' - name: base_type in: query required: false description: ミーティング種別でフィルタ schema: type: string enum: - MEETING - CALL - name: workspace_member_ids in: query required: false description: 参加したワークスペースメンバーIDでフィルタ（カンマ区切りで複数指定可、OR条件） schema: type: string example: c3d4e5f6-...,d4e5f6a7-... - name: meeting_title in: query required: false description: ミーティングタイトルの部分一致でフィルタ schema: type: string example: 商談 - name: meeting_type_definition_id in: query required: false description: ミーティングタイプ定義IDでフィルタ schema: type: integer minimum: 1 example: 12 - name: sort_by in: query required: false description: 並び順に使うフィールド。フィルタ期間は常に `meeting_start_time` に適用されます。 schema: type: string enum: - created_at - meeting_start_time default: created_at - name: sort_order in: query required: false description: 並び順 schema: type: string enum: - asc - desc default: desc - name: limit in: query required: false description: 取得件数の上限（1〜50、デフォルト30） schema: type: integer minimum: 1 maximum: 50 default: 30 - name: cursor in: query required: false description: ページネーションカーソル。レスポンスの next_cursor を指定してください。 schema: type: string responses: '200': description: 成功 content: application/json: schema: type: object required: - data - pagination properties: data: type: array description: Playbook実行結果リスト items: $ref: '#/components/schemas/PlaybookResultListItem' pagination: $ref: '#/components/schemas/Pagination' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/PlaybookNotFound' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: workspaceId: name: X-Workspace-Id in: header required: true description: ワークスペースID schema: type: string example: e1f2a3b4-... playbookId: name: playbookId in: path required: true description: Playbook ID schema: type: string example: d4e5f6a7-... schemas: PlaybookResultListItem: allOf: - $ref: '#/components/schemas/MeetingPlaybookResult' - type: object required: - meeting properties: meeting: $ref: '#/components/schemas/PlaybookResultMeeting' Pagination: type: object required: - next_cursor properties: next_cursor: type: - string - 'null' description: | 次ページ取得用カーソル。 nullの場合、次ページはありません。 example: eyJpZCI6MTIzfQ== MeetingPlaybookResult: type: object description: ミーティングに紐づくPlaybook実行結果 required: - id - playbook_id - playbook_name - created_at - talk_point_results properties: id: type: string description: Playbook実行結果ID example: 8b7c6d5e-... playbook_id: type: string description: Playbook ID example: a1b2c3d4-... playbook_name: type: string description: 実行時点のPlaybook名 example: 商談ヒアリング created_at: type: string format: date-time description: Playbook実行結果の作成日時（UTC） example: '2026-06-05T10:05:00.000Z' talk_point_results: type: array description: Talk Pointごとの結果 items: $ref: '#/components/schemas/MeetingPlaybookResultTalkPoint' PlaybookResultMeeting: type: object description: Playbook実行結果に紐づくミーティング情報 required: - meeting_id - title - start_time - end_time - base_type - meeting_type_name properties: meeting_id: type: string description: ミーティングID example: a1b2c3d4-... title: type: string description: ミーティングタイトル example: 商談ヒアリング 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' base_type: type: string description: ミーティング種別 enum: - MEETING - CALL example: MEETING meeting_type_name: type: - string - 'null' description: ミーティングタイプ名 example: 商談 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 MeetingPlaybookResultTalkPoint: type: object description: Talk PointごとのPlaybook実行結果 required: - id - talk_point_id - question - answer - created_at properties: id: type: string description: Talk Point結果ID example: 9c8d7e6f-... talk_point_id: type: string description: Talk Point ID example: b2c3d4e5-... question: type: string description: Talk Pointの質問 example: 導入課題は何ですか？ answer: type: string description: Talk Pointへの回答 example: 既存CRMとの連携です created_at: type: string format: date-time description: Talk Point結果の作成日時（UTC） example: '2026-06-05T10:06:00.000Z' 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 PlaybookNotFound: description: Playbookが見つかりません content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 404 message: Playbook not found error: 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 ````