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

# Security-Issue-Gruppen auflisten

> Ruft Security-Issues zu Gruppen zusammengefasst mit einer Anzahl pro Gruppe ab. So kann ein Client eine Übersicht anzeigen, ohne jedes Issue herunterzuladen. Akzeptiert dieselben Filter wie GET /issues. Um eine Gruppe aufzuschlüsseln, senden Sie dieselben Filter erneut an GET /issues, ergänzt um cwe oder file_path_exact.



## OpenAPI

````yaml /de/api-reference/openapi.json get /issues/groups
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:
  /issues/groups:
    get:
      tags:
        - Issues
      summary: Security-Issue-Gruppen auflisten
      description: >-
        Ruft Security-Issues zu Gruppen zusammengefasst mit einer Anzahl pro
        Gruppe ab. So kann ein Client eine Übersicht anzeigen, ohne jedes Issue
        herunterzuladen. Akzeptiert dieselben Filter wie GET /issues. Um eine
        Gruppe aufzuschlüsseln, senden Sie dieselben Filter erneut an GET
        /issues, ergänzt um cwe oder file_path_exact.
      operationId: listSecurityIssueGroups
      parameters:
        - name: group_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - cwe
              - file_path
            default: cwe
          description: >-
            Gruppierung der Issues. cwe gruppiert nach CWE-Klassifizierung,
            file_path nach der exakten Datei, in der das jeweilige Issue
            gefunden wurde.
          example: file_path
        - name: breakdown
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Anzahlen pro Dringlichkeit und Status für jede Gruppe einschließen
        - name: project
          in: query
          required: false
          schema:
            type: string
          description: Issues nach Projektname filtern
        - name: repo
          in: query
          required: false
          schema:
            type: string
          description: Issues nach Repository-URL filtern
        - name: branch
          in: query
          required: false
          schema:
            type: string
          description: 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: 100
          description: Anzahl der Gruppen pro Seite
      responses:
        '200':
          description: Issue-Gruppen 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_groups:
                        type: integer
                      groups:
                        type: array
                        items:
                          oneOf:
                            - $ref: '#/components/schemas/IssueCweGroup'
                            - $ref: '#/components/schemas/IssueFileGroup'
                  - type: object
                    properties:
                      status:
                        type: string
                        example: no_project_found
        '400':
          description: Ungültiger Wert für group_by
components:
  schemas:
    IssueCweGroup:
      type: object
      description: >-
        Eine Gruppe von Issues mit derselben CWE-Klassifizierung. Wird
        zurückgegeben, wenn group_by den Wert cwe hat.
      properties:
        cwe:
          type: object
          properties:
            id:
              type: string
              example: CWE-89
            name:
              type: string
            description:
              type: string
        issue_count:
          type: integer
          example: 42
        breakdown:
          $ref: '#/components/schemas/IssueGroupBreakdown'
    IssueFileGroup:
      type: object
      description: >-
        Eine Gruppe von Issues mit demselben Dateipfad. Wird zurückgegeben, wenn
        group_by den Wert file_path hat.
      properties:
        file:
          type: object
          properties:
            path:
              type: string
              example: src/api/auth.py
            name:
              type: string
              example: auth.py
        issue_count:
          type: integer
          example: 7
        breakdown:
          $ref: '#/components/schemas/IssueGroupBreakdown'
    IssueGroupBreakdown:
      type: object
      description: Anzahlen innerhalb der Gruppe. Nur vorhanden, wenn breakdown true ist.
      properties:
        by_urgency:
          type: object
          additionalProperties:
            type: integer
          example:
            CR: 5
            HI: 10
            ME: 20
            LO: 7
        by_status:
          type: object
          additionalProperties:
            type: integer
          example:
            open: 30
            fixed: 5
            false_positive: 2
            accepted_risk: 1
            fix_in_progress: 3
            duplicate: 1
  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.