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

# Count the open findings a bulk-resolve would affect

> Read-only preview of a bulk-resolve: returns how many currently open, unsuppressed findings match the given selection — without resolving anything. project_id scopes the count to one project; when absent the count spans every project in the organization. The selection semantics (reason-derived domain family, suppressed exclusion, purl/path matching) are shared with bulk-resolve so the preview can never diverge from what a confirm would do.



## OpenAPI

````yaml /api-reference/earnie/triage-openapi.json post /v1/findings/actions/bulk-resolve-preview
openapi: 3.0.3
info:
  title: Earnie Findings API
  description: List and read findings, triage them, and review resolutions.
  version: 1.0.0
servers:
  - url: https://{tenant}.earnie.dev
    description: Your Earnie deployment
    variables:
      tenant:
        default: your-company
        description: >-
          Your organization's Earnie address, as shown in your browser when you
          sign in.
security:
  - bearerAuth: []
paths:
  /v1/findings/actions/bulk-resolve-preview:
    post:
      tags:
        - findings
      summary: Count the open findings a bulk-resolve would affect
      description: >-
        Read-only preview of a bulk-resolve: returns how many currently open,
        unsuppressed findings match the given selection — without resolving
        anything. project_id scopes the count to one project; when absent the
        count spans every project in the organization. The selection semantics
        (reason-derived domain family, suppressed exclusion, purl/path matching)
        are shared with bulk-resolve so the preview can never diverge from what
        a confirm would do.
      operationId: PostV1FindingsActionsBulkResolvePreview
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkResolvePreviewRequest'
      responses:
        '200':
          description: Preview count
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkResolvePreviewResponse'
        '400':
          description: Validation error (invalid request)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Not authenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Insufficient permissions (findings:read required)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BulkResolvePreviewRequest:
      type: object
      description: >-
        Selection for a bulk-resolve preview: counts the currently open,
        unsuppressed findings the equivalent bulk-resolve would newly resolve,
        without changing anything.
      required:
        - domain_slug
        - reason_slug
      properties:
        project_id:
          type: string
          format: uuid
          nullable: true
          description: Project scope. Absent or null = organization-wide (all projects).
        domain_slug:
          type: string
          description: Producer domain_slug to filter findings (e.g. "oss").
        path_prefix:
          type: string
          nullable: true
          description: Optional folder path prefix scope filter.
        purl:
          type: string
          nullable: true
          description: >-
            Optional component PURL scope filter. A version-less purl (e.g.
            "pkg:npm/lodash") matches every versioned finding of that base purl
            — the same matching the scan-time Component override applies.
        reason_slug:
          type: string
          description: >-
            Resolve reason slug the eventual bulk-resolve would use (e.g.
            mark_original, replace_component). Determines the finding-domain
            family the selection targets.
    BulkResolvePreviewResponse:
      type: object
      description: Result of a bulk-resolve preview. Read-only — nothing changes.
      required:
        - matching
      properties:
        matching:
          type: integer
          description: >-
            Count of currently open, unsuppressed findings the equivalent
            bulk-resolve would newly resolve.
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An Earnie API key, sent as `Authorization: Bearer sk_earnie_...`. Create
        one under Settings > API keys. The key's scopes decide which operations
        it may call.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.