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

# Get scan findings

> Return the latest succeeded scan in this environment whose target matches repoUrl.

Return the latest **succeeded** scan in the current project and environment whose target matches `repoUrl`.

Accepts `https://github.com/owner/repo`, `.git`, `/tree/<ref>`, and `git@github.com:owner/repo` forms. Medium+ findings are listed first. When no scan matches, `matched` is `false`.

See [Scanner connectors](/latest/openlit/connectors/scanner) for setup.


## OpenAPI

````yaml GET /api/scanners/findings
openapi: 3.0.3
info:
  title: Scanner API
  description: Run Trustabl scanner jobs and retrieve scan findings.
  version: 1.0.0
servers:
  - url: http://localhost:3000
security: []
paths:
  /api/scanners/findings:
    get:
      summary: Get latest scan findings for a repository
      description: >-
        Return the latest succeeded scan in this environment whose target
        matches repoUrl.
      operationId: getScannerFindings
      parameters:
        - name: repoUrl
          in: query
          required: true
          schema:
            type: string
            example: https://github.com/acme/checkout-agent
        - name: x-openlit-organisation-id
          in: header
          required: false
          schema:
            type: string
        - name: x-openlit-project-id
          in: header
          required: true
          schema:
            type: string
        - name: x-openlit-environment
          in: header
          required: true
          schema:
            type: string
            example: production
      responses:
        '200':
          description: Latest matching scan findings, or a miss when none exist.
          content:
            application/json:
              schema:
                type: object
                properties:
                  matched:
                    type: boolean
                  repoKey:
                    type: string
                    nullable: true
                  connectorId:
                    type: string
                  jobId:
                    type: string
                  findings:
                    type: array
                    items:
                      type: object
                      properties:
                        ruleId:
                          type: string
                        severity:
                          type: string
                        path:
                          type: string
                        title:
                          type: string
                  url:
                    type: string
        '400':
          description: repoUrl is missing.
        '401':
          description: Unauthorized.

````