> ## Documentation Index > Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a finding > Returns one finding with its metrics, related findings, latest verification, and latest investigation including causes and suggested fixes. Unlike listing, this reads any finding in the project — quiet and dismissed findings included. `related_findings` is capped at 24 entries. ## OpenAPI ````yaml /api/platform/v1/openapi-platform.yaml get /findings/{finding_id} openapi: 3.1.0 info: title: Kapso Platform API version: 0.2.0 description: > Build WhatsApp messaging into your product. Manage customers, connect phone numbers, send broadcasts, and handle conversations. servers: - url: https://api.kapso.ai/platform/v1 description: Production security: - ApiKeyAuth: [] tags: - name: Customers description: Manage customer accounts - name: Setup Links description: WhatsApp onboarding via embedded signup - name: Phone Numbers description: Connect and manage WhatsApp numbers - name: Webhooks description: Subscribe to WhatsApp events - name: Display Names description: Update WhatsApp business display names - name: Broadcasts description: | Send template messages at scale **Alpha**: This API is in alpha and subject to change - name: Conversations description: Manage conversation state - name: Media description: Upload media files for WhatsApp messaging - name: Users description: Manage project team members - name: Inbox Embeds description: Create and manage embeddable inbox access links - name: Webhook Deliveries description: View webhook delivery attempts and their status - name: External API Logs description: View logs of external API calls made by the project - name: Log Search description: Search log events across API, Meta, workflow, and webhook sources - name: Events description: Emit and query project-scoped events - name: Provider Models description: List available AI provider models - name: WhatsApp Flows description: Build interactive WhatsApp Flows for surveys and forms - name: Contacts description: Manage WhatsApp contacts - name: Findings description: Detect recurring problems in conversations and investigate them with AI paths: /findings/{finding_id}: get: tags: - Findings summary: Get a finding description: > Returns one finding with its metrics, related findings, latest verification, and latest investigation including causes and suggested fixes. Unlike listing, this reads any finding in the project — quiet and dismissed findings included. `related_findings` is capped at 24 entries. operationId: getFinding parameters: - name: finding_id in: path required: true schema: type: string format: uuid responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/FindingDetailResponse' example: data: id: 8f14e45f-ceea-467a-9e1a-1b2c3d4e5f60 source_type: project_event source_key: conversation.user_frustrated signal_name: conversation.user_frustrated direction: rising status: open affected_count: 42 baseline_count: 11 current_rate: 0.18 baseline_rate: 0.05 evidence_revision: 3 last_observed_at: '2026-08-26T09:12:00.000000Z' window_start_at: '2026-08-19T00:00:00.000000Z' window_end_at: '2026-08-26T00:00:00.000000Z' last_qualified_at: '2026-08-26T09:15:00.000000Z' affected_unit: conversations workflow_id: c0ffee00-1111-4222-8333-444455556666 workflow_name: Order support verification: null related_findings: [] investigation: id: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d status: completed retryable: false retry_reason: null error_message: null created_at: '2026-08-26T09:40:00.000000Z' completed_at: '2026-08-26T10:04:00.000000Z' workflow_id: c0ffee00-1111-4222-8333-444455556666 workflow_name: Order support result: summary: >- Users repeat themselves when the workflow loses the order number. alternative_explanations: [] coverage_limitations: [] affected_components: - Order support causes: - title: Checkout step asks for the order number twice explanation: >- The confirm node does not read the value captured earlier. confidence: high evidence_references: - source_type: project_event source_id: 7d1f0e2a-3b4c-4d5e-9f60-718293a4b5c6 observation: >- User resent the order number after the confirm prompt. occurred_at: '2026-08-25T14:02:00.000000Z' suggested_fixes: - title: Reuse the captured order number in the confirm node priority: primary category: workflow change: >- Read `order_number` from state instead of prompting again. verification: >- Frustration events should drop below the 5% baseline. target: name: Order support location: Confirm order node evidence_references: [] '401': $ref: '#/components/responses/UnauthorizedError' '404': description: > Finding not found (`finding_not_found`), or Findings is not enabled for this project (`findings_not_enabled`). Read `code` to tell them apart. content: application/json: schema: $ref: '#/components/schemas/FindingsErrorResponse' example: error: Finding not found in this project. code: finding_not_found components: schemas: FindingDetailResponse: type: object required: - data properties: data: $ref: '#/components/schemas/FindingDetail' FindingsErrorResponse: type: object required: - error properties: error: type: string code: type: string enum: - findings_not_enabled - finding_not_found - investigation_unavailable description: > Machine-readable reason. Present on both `404` cases and on an ineligible investigation. Absent on validation and pagination errors. FindingDetail: type: object required: - id - source_type - source_key - signal_name - direction - status - affected_count - baseline_count - current_rate - baseline_rate - evidence_revision - last_observed_at - window_start_at - window_end_at - last_qualified_at - affected_unit - workflow_id - workflow_name - verification - related_findings - investigation properties: id: type: string format: uuid source_type: type: string enum: - project_event source_key: type: string signal_name: type: string direction: type: string enum: - rising - falling - recurring status: type: string enum: - candidate - open - quiet affected_count: type: integer baseline_count: type: - integer - 'null' current_rate: type: - number - 'null' description: Share of conversations in the current window, from 0 to 1. baseline_rate: type: - number - 'null' evidence_revision: type: integer description: Increments when new qualifying evidence arrives. last_observed_at: type: string format: date-time window_start_at: type: string format: date-time window_end_at: type: string format: date-time last_qualified_at: type: string format: date-time affected_unit: type: string enum: - conversations - events workflow_id: type: - string - 'null' format: uuid workflow_name: type: - string - 'null' verification: oneOf: - $ref: '#/components/schemas/FindingVerification' - type: 'null' related_findings: type: array items: $ref: '#/components/schemas/RelatedFinding' investigation: oneOf: - $ref: '#/components/schemas/FindingInvestigation' - type: 'null' ErrorResponse: type: object required: - error properties: error: type: string FindingVerification: type: object required: - id - status - trigger_type - from_workflow_version - to_workflow_version - started_at - completed_at properties: id: type: string format: uuid status: type: string enum: - monitoring - resolved - not_improved - dismissed trigger_type: type: string enum: - workflow_version - regression - manual from_workflow_version: type: - integer - 'null' to_workflow_version: type: - integer - 'null' started_at: type: - string - 'null' format: date-time completed_at: type: - string - 'null' format: date-time RelatedFinding: type: object required: - id - source_type - source_key - signal_name - direction - affected_count - baseline_count - current_rate - baseline_rate - window_start_at - window_end_at - affected_unit - evidence_revision properties: id: type: string format: uuid source_type: type: string enum: - project_event source_key: type: string signal_name: type: string direction: type: string enum: - rising - falling - recurring affected_count: type: integer baseline_count: type: - integer - 'null' current_rate: type: - number - 'null' description: Share of conversations in the current window, from 0 to 1. baseline_rate: type: - number - 'null' window_start_at: type: string format: date-time window_end_at: type: string format: date-time affected_unit: type: string enum: - conversations - events evidence_revision: type: integer FindingInvestigation: type: object required: - id - status - retryable - retry_reason - error_message - created_at - completed_at - workflow_id - workflow_name - result properties: id: type: string format: uuid status: type: string enum: - queued - investigating - completed - failed - timed_out retryable: type: boolean retry_reason: type: - string - 'null' error_message: type: - string - 'null' created_at: type: string format: date-time completed_at: type: - string - 'null' format: date-time workflow_id: type: - string - 'null' format: uuid workflow_name: type: - string - 'null' result: $ref: '#/components/schemas/FindingInvestigationResult' FindingInvestigationResult: type: object required: - summary - alternative_explanations - coverage_limitations - affected_components - causes - suggested_fixes properties: summary: type: - string - 'null' alternative_explanations: type: - array - 'null' items: type: string coverage_limitations: type: - array - 'null' items: type: string affected_components: type: - array - 'null' items: type: string causes: type: array items: $ref: '#/components/schemas/FindingCause' suggested_fixes: type: array items: $ref: '#/components/schemas/FindingSuggestedFix' FindingCause: type: object required: - title - explanation - confidence - evidence_references properties: title: type: string explanation: type: string confidence: type: string enum: - low - medium - high evidence_references: type: array items: $ref: '#/components/schemas/FindingEvidenceReference' FindingSuggestedFix: type: object required: - title - priority - category - change - verification - target - evidence_references properties: title: type: string priority: type: string enum: - primary - secondary description: Exactly one suggested fix per investigation is `primary`. category: type: string enum: - workflow - code - evaluation - configuration description: What kind of thing has to change. change: type: string description: What to change. verification: type: string description: How to verify the fix. target: type: object required: - name - location properties: name: type: - string - 'null' location: type: - string - 'null' evidence_references: type: array items: $ref: '#/components/schemas/FindingEvidenceReference' FindingEvidenceReference: type: object required: - source_type - source_id - observation - occurred_at properties: source_type: type: string source_id: type: - string - 'null' observation: type: - string - 'null' occurred_at: type: - string - 'null' format: date-time responses: UnauthorizedError: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````