findings

List findings (agent contract v2)

Severity-ordered findings with run-scoped ids, evidence, affected URLs, and remediation. Read get_report_context first for orientation, then page through here. Filter with severity/category.

get/api/v1/runs/{runId}/findings

Request

  • Base URL: https://index365.co
  • URL: https://index365.co/api/v1/runs/{runId}/findings
  • Auth: HTTP bearer

Path parameters

runIdstring uuid required

Completed run to read findings from.

Query parameters

limitinteger

Page size (max 100).

cursorstring

Opaque cursor from the previous page's pagination.nextCursor.

severity'critical' | 'high' | 'medium' | 'low' | 'info'
category'discoverability' | 'structured_data' | 'metadata' | 'content_structure' | 'accessibility' | 'answerability' | 'agent_operability' | 'performance' | 'security' | 'general' | 'findability' | 'measurement' | 'conversion_path' | 'offer_clarity' | 'trust_proof' | 'schema_metadata' | 'social_preview' | 'performance_ux' | 'consent_privacy_signal' | 'connected_account'
stage'find' | 'trust' | 'act' | 'measure' | 'improve'

Marketing Signal funnel stage (Marketing Signal findings only).

Filter legacy Marketing findings by funnel stage.

marketingCategory'seo' | 'content' | 'aeo' | 'analytics_tracking' | 'conversion' | 'trust_proof'

Filter Marketing Signal findings by report category. Separate from category, which is the shared cross-product taxonomy.

Response

Finding page.

schemaVersioninteger
runIdstring
findingsTotalinteger

Example response

{
  "findings": [
    {
      "findingId": "f_1a2b3c4d5e6f7a8b"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.