> ## 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 abrufen

> Ruft eine Liste der Software-Composition-Analysis-Detections (SCA) ab Ohne Scan-ID wird der neueste passende verarbeitete Scan bevorzugt, der das gesamte Projekt abdeckt und keinem PR zugeordnet ist. Fehlt ein solcher Scan, wird der neueste passende Scan verwendet. Ein expliziter Filter scan_type bei /detections oder /detections/code-quality wählt stattdessen den neuesten Scan dieses Typs.

Auch unter `/api/v1/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 /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:
  /detections/sca:
    get:
      tags:
        - Detections
        - SCA
      summary: SCA-Detections abrufen
      description: >-
        Ruft eine Liste der Software-Composition-Analysis-Detections (SCA) ab
        Ohne Scan-ID wird der neueste passende verarbeitete Scan bevorzugt, der
        das gesamte Projekt abdeckt und keinem PR zugeordnet ist. Fehlt ein
        solcher Scan, wird der neueste passende Scan verwendet. Ein expliziter
        Filter scan_type bei /detections oder /detections/code-quality wählt
        stattdessen den neuesten Scan dieses Typs.


        Auch unter `/api/v1/issues/sca` erreichbar, dem früheren Namen dieses
        Endpunkts, der weiterhin mit denselben Parametern und derselben Antwort
        unterstützt wird.
      operationId: listScaIssues
      parameters:
        - name: project
          in: query
          required: false
          schema:
            type: string
          description: SCA-Issues nach Projektname filtern
        - name: repo
          in: query
          required: false
          schema:
            type: string
          description: SCA-Issues nach Repository-URL filtern
        - name: branch
          in: query
          required: false
          schema:
            type: string
          description: SCA-Issues nach Branch-Name filtern
        - 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 oder kein Projekt gefunden
          content:
            application/json:
              schema:
                oneOf:
                  - 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'
                  - type: object
                    properties:
                      status:
                        type: string
                        example: no_project_found
        '403':
          description: Zugriff verweigert
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Permission denied
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.