openapi: 3.1.0
info:
  title: Kyverno Policy Reporter ClusterPolicyReports Sources API
  description: The Kyverno Policy Reporter REST API provides endpoints for querying PolicyReport and ClusterPolicyReport custom resources generated by Kyverno. It exposes policy results, status counts, and resource-level violation data, serving as the backend for the Policy Reporter UI. The API enables programmatic access to policy compliance status across namespaces and clusters.
  version: 2.0.0
  contact:
    name: Kyverno Community
    url: https://kyverno.io/community/
  termsOfService: https://kyverno.io/
servers:
- url: http://localhost:8080
  description: Default Policy Reporter server
tags:
- name: Sources
  description: Policy source listing endpoints
paths:
  /api/v1/sources:
    get:
      operationId: listSources
      summary: Kyverno List policy sources
      description: Returns a list of policy source names that have generated reports. Policy sources include kyverno, kube-bench, trivy, and other policy engines that produce PolicyReport resources.
      tags:
      - Sources
      responses:
        '200':
          description: List of policy source names
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                  example: kyverno
externalDocs:
  description: Policy Reporter API Reference
  url: https://kyverno.github.io/policy-reporter/core/api-reference/