> ## 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. # Findings auflisten > Eine Zeile pro Finding: eine Schwachstelle in einem Projekt über alle Scans hinweg, die sie erkannt haben, mit ihrem Triage-Status und ihrer neuesten Detection. Neueste zuerst nach dem Zeitpunkt der ersten Erkennung; bei gleicher Sortierung entscheidet die ID, damit die Seiten stabil bleiben. Antwortet mit 404, bis der Finding-Index des Kontos vollständig aufgebaut ist. ## OpenAPI ````yaml /de/api-reference/openapi.json get /findings 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: get: tags: - Findings summary: Findings auflisten description: >- Eine Zeile pro Finding: eine Schwachstelle in einem Projekt über alle Scans hinweg, die sie erkannt haben, mit ihrem Triage-Status und ihrer neuesten Detection. Neueste zuerst nach dem Zeitpunkt der ersten Erkennung; bei gleicher Sortierung entscheidet die ID, damit die Seiten stabil bleiben. Antwortet mit 404, bis der Finding-Index des Kontos vollständig aufgebaut ist. operationId: listFindings parameters: - name: issue_type in: query required: false schema: type: string example: sast,dependency description: >- Kommagetrennte Familien. Standard: alle Security-Familien, die das Token sehen darf (alle außer code_quality). Wird eine Familie angegeben, die das Token nicht sehen darf, antwortet die API mit 403. - name: status in: query required: false schema: type: string example: open,fix_in_progress description: Kommagetrennte Status. - name: urgency in: query required: false schema: type: string example: CR,HI description: Kommagetrennte Dringlichkeitsstufen. - name: project_id in: query required: false schema: type: string example: 12,15 description: Kommagetrennte Projekt-IDs. - name: project in: query required: false schema: type: string description: Ein Projektname. - name: repo in: query required: false schema: type: string description: Teilzeichenfolge der Repository-URL. - name: cwe in: query required: false schema: type: string example: CWE-79,CWE-89 description: Kommagetrennte CWE-Kennungen, als CWE-79 oder 79. - name: detection_state in: query required: false schema: type: string enum: - active - retired - all default: active description: >- active: Das Finding hat eine Detection in seinem Projekt (Standard). retired: Seine letzte Detection wurde mit ihrem Scan oder Projekt gelöscht. all: beides. - name: status_changed_since in: query required: false schema: type: string example: '2026-10-01T00:00:00Z' description: >- Zeitstempel nach ISO 8601 oder ein Datum, das als Mitternacht UTC gelesen wird. Findings, deren Triage sich nach diesem Zeitpunkt geändert hat; geeignet für die inkrementelle Synchronisierung. - name: created_since in: query required: false schema: type: string example: '2026-10-01T00:00:00Z' description: >- Zeitstempel nach ISO 8601 oder ein Datum, das als Mitternacht UTC gelesen wird. Findings, die nach diesem Zeitpunkt erstmals erkannt wurden. - name: assigned_to in: query required: false schema: type: integer description: Eine Benutzer-ID. - name: sort_by in: query required: false schema: type: string enum: - '-created_at' - created_at - urgency - '-urgency' - status - '-status' - status_changed_at - '-status_changed_at' default: '-created_at' description: >- Sortierreihenfolge. created_at ist der Zeitpunkt, zu dem das Finding erstmals erkannt wurde, und der Wert, auf den created_since filtert; er ist nicht Teil der Antwort und entspricht first_detection_date, sofern die ältesten Detections des Findings nicht mit ihrem Scan gelöscht wurden. Bei gleichen Sortierwerten entscheidet die ID. - 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: 100 description: Anzahl der Ergebnisse pro Seite responses: '200': description: Findings erfolgreich abgerufen content: application/json: schema: type: object properties: status: type: string example: ok page: type: integer total_pages: type: integer total_findings: type: integer findings: type: array items: $ref: '#/components/schemas/Finding' '400': description: Ungültiger Parameterwert '403': description: Das Token darf eine der angeforderten Finding-Familien nicht sehen '404': description: Der Finding-Index des Kontos ist noch nicht vollständig aufgebaut 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.