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

# SCA-Detections eines Scans abrufen

> Ruft SCA-Detections für einen bestimmten Scan ab

Auch unter `/api/v1/scan/{scan_id}/issues/sca` erreichbar, dem früheren Namen dieses Endpunkts, der weiterhin mit denselben Parametern und derselben Antwort unterstützt wird.



## OpenAPI

````yaml /de/api-reference/openapi.json get /scan/{scan_id}/detections/sca
openapi: 3.0.0
info:
  title: Corgea API
  version: 1.0.0
  description: >-
    API für die Interaktion mit den Scan- und
    Schwachstellenmanagement-Funktionen von Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Produktionsserver
  - url: https://eu.corgea.app/api/v1
    description: EU-Produktionsserver
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /scan/{scan_id}/detections/sca:
    get:
      tags:
        - Detections
        - SCA
      summary: SCA-Detections eines Scans abrufen
      description: >-
        Ruft SCA-Detections für einen bestimmten Scan ab


        Auch unter `/api/v1/scan/{scan_id}/issues/sca` erreichbar, dem früheren
        Namen dieses Endpunkts, der weiterhin mit denselben Parametern und
        derselben Antwort unterstützt wird.
      operationId: getScanScaIssues
      parameters:
        - name: scan_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ID des Scans
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Seitennummer für die Paginierung
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 50
          description: Anzahl der Ergebnisse pro Seite
        - name: severity
          in: query
          required: false
          schema:
            type: string
          description: >-
            Nach Schweregraden filtern (kommagetrennt). Gültige Werte: CRITICAL,
            HIGH, MEDIUM, LOW
          example: CRITICAL,HIGH
        - name: package
          in: query
          required: false
          schema:
            type: string
          description: Nach Paketname filtern (Teilübereinstimmung)
          example: lodash
        - name: ecosystem
          in: query
          required: false
          schema:
            type: string
          description: >-
            Nach Paket-Ökosystem filtern (ohne Berücksichtigung der Groß- und
            Kleinschreibung)
          example: npm
        - name: cve
          in: query
          required: false
          schema:
            type: string
          description: Nach CVE-Kennung filtern (Teilübereinstimmung)
          example: CVE-2021
        - name: path
          in: query
          required: false
          schema:
            type: string
          description: Nach Dateipfad filtern (Teilübereinstimmung)
          example: package.json
        - name: has_fix
          in: query
          required: false
          schema:
            type: boolean
          description: Danach filtern, ob ein Fix verfügbar ist (true/false)
          example: true
        - name: reachability
          in: query
          required: false
          schema:
            type: string
            enum:
              - not_direct_dependency
              - pending
              - vulnerable_usage_reachable
              - vulnerable_usage_unreachable
              - dead_dependency
          description: SCA-Issues nach Erreichbarkeitsstatus der Abhängigkeit filtern
          example: vulnerable_usage_reachable
        - name: include_reachability
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Erreichbarkeitsstatus und -beschreibung der Abhängigkeit für jedes
            SCA-Issue einschließen.
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
              - severity
              - '-severity'
              - package
              - '-package'
              - ecosystem
              - '-ecosystem'
          description: >-
            Ergebnisse nach Feld sortieren (für absteigende Reihenfolge ein '-'
            voranstellen)
          example: '-severity'
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: >-
            Nach Triage-Status filtern (kommagetrennt). Gültige Werte: open,
            fixed, false_positive, accepted_risk, duplicate
          example: open
        - name: package_exact
          in: query
          required: false
          schema:
            type: string
          description: >-
            Nach einem exakten Paketnamen filtern. Anders als package werden
            keine Pakete gefunden, die den Wert nur enthalten (lodash findet
            nicht lodash.merge). Dadurch eignet sich der Filter zum
            Aufschlüsseln einer Paketgruppe.
          example: lodash
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: >-
            Freitextsuche in Paketname, CVE-Kennung, Zusammenfassung, Details,
            Pfad und Klassifizierung
          example: lodash
      responses:
        '200':
          description: SCA-Issues erfolgreich abgerufen
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  page:
                    type: integer
                  total_pages:
                    type: integer
                  total_issues:
                    type: integer
                  issues:
                    type: array
                    items:
                      $ref: '#/components/schemas/SCAIssue'
        '403':
          description: Zugriff verweigert
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Permission denied
        '404':
          description: Scan nicht gefunden
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  message:
                    type: string
                    example: Scan not found
components:
  schemas:
    SCAIssue:
      type: object
      properties:
        finding_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            ID des Findings, von dem dieses Issue eine Detection ist: über
            Rescans hinweg dieselbe. Null bei einem Issue, das erfasst wurde,
            bevor es Findings gab.
        id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        description:
          type: string
        details:
          type: string
        severity:
          type: string
          nullable: true
          enum:
            - CRITICAL
            - HIGH
            - MEDIUM
            - LOW
          description: >-
            Vom Abhängigkeitsscanner gemeldeter Schweregrad, normalerweise in
            Großbuchstaben. Vergleichen Sie Werte ohne Berücksichtigung der
            Groß-/Kleinschreibung.
        cvss_score:
          type: number
          nullable: true
        classification:
          type: string
          nullable: true
          description: >-
            Bedrohungsklassifizierung wie malicious, unabhängig vom Schweregrad.
            null, wenn das Issue keine Klassifizierung hat.
        cve:
          type: string
          description: CVE-Kennung, sofern verfügbar
        package:
          type: object
          properties:
            name:
              type: string
            version:
              type: string
            ecosystem:
              type: string
            fix_version:
              type: string
              description: Version, die die Schwachstelle behebt
        location:
          type: object
          properties:
            path:
              type: string
              description: Pfad zur Datei mit dem anfälligen Paket
        reachability:
          $ref: '#/components/schemas/SCAReachability'
    SCAReachability:
      type: object
      properties:
        status:
          type: string
          enum:
            - not_direct_dependency
            - pending
            - vulnerable_usage_reachable
            - vulnerable_usage_unreachable
            - dead_dependency
            - not_applicable
          description: >-
            Erreichbarkeitsstatus. not_applicable wird nur beim Abrufen eines
            einzelnen Container-Issues zurückgegeben.
        description:
          type: string
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: >-
        API-Key für die Authentifizierung API-Tokens inaktiver Benutzer werden
        abgelehnt.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth2-Access-Token (JWT) im Authorization-Header

````

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