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

# Finding abrufen

> Ein einzelnes Finding beliebiger Familie mit seinem Triage-Status, Anzahl und Daten seiner Detections sowie seiner neuesten Detection. Das Token benötigt dieselbe Leseberechtigung wie für die Issue-Liste der jeweiligen Familie.



## OpenAPI

````yaml /de/api-reference/openapi.json get /findings/{finding_id}
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:
  /findings/{finding_id}:
    get:
      tags:
        - Findings
      summary: Finding abrufen
      description: >-
        Ein einzelnes Finding beliebiger Familie mit seinem Triage-Status,
        Anzahl und Daten seiner Detections sowie seiner neuesten Detection. Das
        Token benötigt dieselbe Leseberechtigung wie für die Issue-Liste der
        jeweiligen Familie.
      operationId: getFinding
      parameters:
        - name: finding_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            ID des Findings, wie sie als finding_id bei Issue-Elementen
            erscheint
      responses:
        '200':
          description: Finding erfolgreich abgerufen
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  finding:
                    $ref: '#/components/schemas/Finding'
        '403':
          description: Das Token darf eine der angeforderten Finding-Familien nicht sehen
        '404':
          description: Kein zugängliches Finding mit dieser ID
components:
  schemas:
    Finding:
      type: object
      description: >-
        Eine Schwachstelle in einem Projekt über alle Scans hinweg, die sie
        erkannt haben. Die ID bleibt über Rescans, Branches und
        Fingerprint-Migrationen hinweg stabil; die Triage findet hier statt und
        wird auf jede seiner Detections (Issues) gespiegelt.
      properties:
        id:
          type: string
          format: uuid
        issue_type:
          type: string
          enum:
            - sast
            - secret
            - logic_auth
            - code_quality
            - dependency
            - container
            - iac
        detection_state:
          type: string
          nullable: true
          enum:
            - active
            - retired
          description: >-
            active, solange das Finding eine Detection in seinem Projekt hat;
            retired, sobald seine letzte Detection mit ihrem Scan oder Projekt
            gelöscht wurde. Ein Finding, das ein Rescan nicht mehr meldet,
            bleibt active mit dem Status fixed. Null, bis der Finding-Index des
            Kontos vollständig aufgebaut ist.
        status:
          type: string
          enum:
            - open
            - fix_in_progress
            - accepted_risk
            - false_positive
            - fixed
            - duplicate
        status_comment:
          type: string
          nullable: true
        status_changed_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Zeitpunkt der letzten Statusänderung; filtern Sie darauf mit
            status_changed_since.
        status_changed_by:
          allOf:
            - $ref: '#/components/schemas/AssignedTo'
          nullable: true
          description: Benutzer, der die letzte Statusänderung vorgenommen hat, oder null.
        accepted_risk_expiry_date:
          type: string
          format: date-time
          nullable: true
        assigned_to:
          $ref: '#/components/schemas/AssignedTo'
        due_date:
          type: string
          format: date-time
          nullable: true
        sla_status:
          type: string
          nullable: true
        urgency:
          type: string
          enum:
            - CR
            - HI
            - ME
            - LO
        classification:
          type: object
          nullable: true
          properties:
            id:
              type: string
              example: CWE-79
            name:
              type: string
            description:
              type: string
              nullable: true
        project:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
        first_detection_date:
          type: string
          format: date-time
          nullable: true
          description: created_at der ältesten Detection.
        last_detection_date:
          type: string
          format: date-time
          nullable: true
          description: created_at der neuesten Detection.
        detections_count:
          type: integer
          description: Anzahl der Detections des Findings über alle Scans hinweg.
        latest_detection:
          allOf:
            - $ref: '#/components/schemas/FindingLatestDetection'
          nullable: true
          description: >-
            Die neueste Detection des Findings: Ihre ID ist die, die die
            Issue-Endpunkte erwarten, und sie enthält den Locator der jeweiligen
            Familie.
    AssignedTo:
      type: object
      nullable: true
      description: >-
        Dem Issue zugewiesener Benutzer oder null, wenn das Issue nicht
        zugewiesen ist.
      properties:
        id:
          type: string
          description: ID des zugewiesenen Benutzers.
        email:
          type: string
          format: email
          description: E-Mail-Adresse des zugewiesenen Benutzers.
        name:
          type: string
          nullable: true
          description: >-
            Anzeigename des zugewiesenen Benutzers oder null, wenn nicht
            verfügbar.
    FindingLatestDetection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: >-
            Detection-ID (Issue-ID) für /issue/{issue_id} und
            /issues/sca/{issue_id}.
        scan_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Scan, zu dem die Detection gehört; null bei einer SAST-Detection,
            die ohne Scan erfasst wurde.
        branch:
          type: string
          nullable: true
        sha:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        file_path:
          type: string
          description: Nur bei SAST-, Secret-, Logic- und Code-Quality-Findings.
        line_number:
          type: integer
          nullable: true
          description: Nur bei SAST-, Secret-, Logic- und Code-Quality-Findings.
        path:
          type: string
          description: Nur bei Dependency-, Container- und IaC-Findings.
        package:
          type: string
          description: Nur bei Dependency- und Container-Findings.
        version:
          type: string
          description: Nur bei Dependency- und Container-Findings.
        cve:
          type: string
          nullable: true
          description: Nur bei Dependency- und Container-Findings.
        rule_id:
          type: string
          description: Nur bei IaC-Findings.
        start_line:
          type: integer
          nullable: true
          description: Nur bei IaC-Findings.
        end_line:
          type: integer
          nullable: true
          description: Nur bei IaC-Findings.
  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.