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

# Listar grupos de hallazgos de seguridad de un escaneo

> Obtiene los hallazgos de seguridad de un escaneo agrupados, con un recuento por grupo, para que un cliente pueda mostrar un resumen sin descargar todos los hallazgos. Acepta los mismos filtros que GET /scan/{scan_id}/issues.



## OpenAPI

````yaml /es/api-reference/openapi.json get /scan/{scan_id}/issues/groups
openapi: 3.0.0
info:
  title: API de Corgea
  version: 1.0.0
  description: >-
    API para interactuar con las funciones de escaneo y gestión de
    vulnerabilidades de Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Servidor de producción
  - url: https://eu.corgea.app/api/v1
    description: Servidor de producción de la UE
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /scan/{scan_id}/issues/groups:
    get:
      tags:
        - Hallazgos
        - Escaneos
      summary: Listar grupos de hallazgos de seguridad de un escaneo
      description: >-
        Obtiene los hallazgos de seguridad de un escaneo agrupados, con un
        recuento por grupo, para que un cliente pueda mostrar un resumen sin
        descargar todos los hallazgos. Acepta los mismos filtros que GET
        /scan/{scan_id}/issues.
      operationId: listSecurityIssueGroupsForScan
      parameters:
        - name: scan_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Escaneo cuyos hallazgos se deben agrupar
        - name: group_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - cwe
              - file_path
            default: cwe
          description: >-
            Cómo agrupar los hallazgos. cwe agrupa por clasificación CWE y
            file_path agrupa por el archivo exacto en el que se encontró cada
            hallazgo.
          example: file_path
        - name: breakdown
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Incluye en cada grupo los recuentos por urgencia y por estado
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Número de página de la paginación
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Número de grupos por página
      responses:
        '200':
          description: Grupos de hallazgos obtenidos correctamente
          content:
            application/json:
              schema:
                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'
        '400':
          description: Valor de group_by no válido
        '404':
          description: Escaneo no encontrado
components:
  schemas:
    IssueCweGroup:
      type: object
      description: >-
        Grupo de hallazgos que comparten la misma clasificación CWE; se devuelve
        cuando group_by es cwe.
      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: >-
        Grupo de hallazgos que comparten la misma ruta de archivo; se devuelve
        cuando group_by es file_path.
      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: Recuentos dentro del grupo; solo se incluyen cuando breakdown es true.
      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: >-
        Clave de API para la autenticación Se rechazan los tokens de API de
        usuarios inactivos.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token de acceso OAuth2 (JWT) en el encabezado Authorization

````

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