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

# List organization security finding occurrences

> Pages one finding's occurrences by the status predicates its row counts with, so every count on the finding row can be expanded into the rows behind it. Resolved occurrences list newest resolution first; every other status lists in the finding detail's workload order.



## OpenAPI

````yaml https://platform.ankra.app/openapi.json get /org/security/findings/{finding_id}/occurrences
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
tags:
  - name: Clusters
    description: Create, inspect and manage clusters, and the stacks deployed on them.
  - name: Managed Clusters
    description: Provider-managed control planes, driven through one common surface.
  - name: Imported Clusters
    description: Clusters that already existed and were connected to Ankra.
  - name: Cluster Access
    description: Kubeconfigs, service-account tokens and per-cluster access grants.
  - name: Kubernetes
    description: Read and act on the Kubernetes objects inside a cluster.
  - name: DigitalOcean Clusters
    description: Provision and manage DigitalOcean Kubernetes clusters.
  - name: Hetzner Clusters
    description: Provision and manage Hetzner Kubernetes clusters.
  - name: OVH Clusters
    description: Provision and manage OVH Kubernetes clusters.
  - name: Scaleway Clusters
    description: Provision and manage Scaleway Kapsule clusters.
  - name: UpCloud Clusters
    description: Provision and manage UpCloud Kubernetes clusters.
  - name: Applications
    description: Deploy, configure and observe applications across the fleet.
  - name: Stack Profiles
    description: Reusable stack definitions, their versions and sharing.
  - name: Charts
    description: Browse the chart catalogue behind stacks and addons.
  - name: Helm
    description: Helm registries, credentials and the charts they expose.
  - name: Executions
    description: Long-running platform executions and their jobs.
  - name: Operations
    description: Cancel in-flight cluster operations and their jobs.
  - name: Chat
    description: Conversational sessions, plans and confirmable actions.
  - name: AI Agent Runs
    description: Autonomous agent runs and their outcomes.
  - name: AI Tickets
    description: The AI ticket board, its sync connections and settings.
  - name: AI Playbooks
    description: Reusable playbooks the AI lanes execute.
  - name: AI Conditions
    description: Conditions that gate AI autonomy.
  - name: AI Engineering Handoffs
    description: Work the AI lanes escalate to a human engineer.
  - name: AI Environment
    description: The environment and base stacks AI demos deploy into.
  - name: Security
    description: Findings, advisories, SBOMs, compliance and posture.
  - name: Cost
    description: Cluster and fleet cost, rate cards and cost settings.
  - name: Billing
    description: Subscription and spend caps.
  - name: Organisation
    description: Members, invitations, audit logs and organisation settings.
  - name: Account Tokens
    description: Personal access tokens for the API and CLI.
  - name: Credentials
    description: The shared credential store.
  - name: Azure Credentials
    description: Azure credentials and SSH keys.
  - name: DigitalOcean Credentials
    description: DigitalOcean credentials and SSH keys.
  - name: Hetzner Credentials
    description: Hetzner credentials and SSH keys.
  - name: OVH Credentials
    description: OVH credentials and SSH keys.
  - name: Scaleway Credentials
    description: Scaleway credentials.
  - name: UpCloud Credentials
    description: UpCloud credentials and SSH keys.
  - name: Data Source Credentials
    description: Credentials for metrics and log sources.
  - name: DNS Credentials
    description: Credentials for DNS providers.
  - name: DNS
    description: DNS zones and records, including custom organisation zones.
  - name: Cloudflare
    description: Cloudflare domains and the credentials behind them.
  - name: Variables
    description: Organisation- and cluster-scoped variables.
  - name: SOPS
    description: Encrypt and decrypt values with the organisation SOPS config.
  - name: Alerts
    description: Alert integrations and ingest credentials.
  - name: Notifications
    description: Notification routes and their delivery targets.
  - name: Support
    description: Support tickets.
paths:
  /org/security/findings/{finding_id}/occurrences:
    get:
      tags:
        - Security
      summary: List organization security finding occurrences
      description: >-
        Pages one finding's occurrences by the status predicates its row counts
        with, so every count on the finding row can be expanded into the rows
        behind it. Resolved occurrences list newest resolution first; every
        other status lists in the finding detail's workload order.
      operationId: list_security_finding_occurrences
      parameters:
        - in: path
          name: finding_id
          required: true
          schema:
            format: uuid
            type: string
        - in: query
          name: page
          required: false
          schema:
            default: 1
            maximum: 10000
            minimum: 1
            type: integer
        - description: Values above 100 are clamped to 100.
          in: query
          name: page_size
          required: false
          schema:
            default: 50
            minimum: 1
            type: integer
        - description: >-
            Keep only occurrences in one status, using the same predicates the
            finding row's disposition_counts are built from: open is active with
            no disposition, acknowledged and accepted_risk are active with that
            disposition, resolved is the resolved scan state. Omit it to list
            every occurrence, live and resolved.
          in: query
          name: status
          required: false
          schema:
            enum:
              - open
              - acknowledged
              - accepted_risk
              - resolved
            type: string
        - description: Keep only occurrences observed on this cluster.
          in: query
          name: cluster_id
          required: false
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityFindingOccurrenceListResponse'
          description: Successful response
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityDetailError'
          description: Business validation error
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityPermissionDenied'
          description: Permission or CSRF denied
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityDetailError'
          description: Organization-scoped resource not found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Request validation error
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecurityDetailError'
          description: Internal server error
components:
  schemas:
    SecurityFindingOccurrenceListResponse:
      properties:
        pagination:
          $ref: '#/components/schemas/SecurityPagination'
        result:
          items:
            $ref: '#/components/schemas/SecurityOccurrence'
          type: array
      required:
        - result
        - pagination
      type: object
    SecurityDetailError:
      properties:
        detail:
          type: string
      required:
        - detail
      type: object
    SecurityPermissionDenied:
      properties:
        detail:
          enum:
            - permission_denied
          type: string
        permission:
          type: string
        scope_type:
          type: string
      required:
        - detail
        - permission
        - scope_type
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    SecurityPagination:
      properties:
        page:
          type: integer
        page_size:
          type: integer
        total_count:
          type: integer
        total_pages:
          type: integer
      required:
        - page
        - page_size
        - total_pages
        - total_count
      type: object
    SecurityOccurrence:
      properties:
        addon_attribution_confidence:
          type: string
        addon_attribution_reason:
          type: string
        addon_slug:
          anyOf:
            - type: string
            - type: 'null'
        cluster_id:
          format: uuid
          type: string
        cluster_name:
          type: string
        container_name:
          anyOf:
            - type: string
            - type: 'null'
        effective_disposition:
          type: string
        effective_policy_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
        first_seen_at:
          format: date-time
          type: string
        fixed_version:
          anyOf:
            - type: string
            - type: 'null'
        id:
          format: uuid
          type: string
        image_digest:
          anyOf:
            - type: string
            - type: 'null'
        image_ref:
          anyOf:
            - type: string
            - type: 'null'
        installed_version:
          anyOf:
            - type: string
            - type: 'null'
        last_evaluated_at:
          format: date-time
          type: string
        last_seen_at:
          format: date-time
          type: string
        report_name:
          type: string
        report_namespace:
          anyOf:
            - type: string
            - type: 'null'
        report_scope:
          type: string
        report_uid:
          anyOf:
            - type: string
            - type: 'null'
        resolved_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
        scan_state:
          type: string
        workload_kind:
          anyOf:
            - type: string
            - type: 'null'
        workload_name:
          anyOf:
            - type: string
            - type: 'null'
        workload_namespace:
          anyOf:
            - type: string
            - type: 'null'
        workload_uid:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - id
        - cluster_id
        - cluster_name
        - report_scope
        - report_uid
        - report_name
        - report_namespace
        - workload_uid
        - workload_kind
        - workload_namespace
        - workload_name
        - container_name
        - image_ref
        - image_digest
        - installed_version
        - fixed_version
        - addon_slug
        - addon_attribution_confidence
        - addon_attribution_reason
        - scan_state
        - effective_disposition
        - effective_policy_id
        - first_seen_at
        - last_seen_at
        - last_evaluated_at
        - resolved_at
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````