> ## 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 SCA de un escaneo

> Obtiene los hallazgos de SCA 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/sca.



## OpenAPI

````yaml /es/api-reference/openapi.json get /scan/{scan_id}/issues/sca/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/sca/groups:
    get:
      tags:
        - Hallazgos
        - SCA
        - Escaneos
      summary: Listar grupos de hallazgos de SCA de un escaneo
      description: >-
        Obtiene los hallazgos de SCA 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/sca.
      operationId: listScaIssueGroupsForScan
      parameters:
        - name: scan_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Escaneo cuyos hallazgos de SCA se deben agrupar
        - name: group_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - package
            default: package
          description: >-
            Cómo agrupar los hallazgos de SCA. Actualmente solo se admite
            package.
        - name: breakdown
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Incluye en cada grupo los recuentos por gravedad 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 de SCA 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:
                      $ref: '#/components/schemas/SCAIssuePackageGroup'
        '400':
          description: Valor de group_by no válido
        '404':
          description: Escaneo no encontrado
components:
  schemas:
    SCAIssuePackageGroup:
      type: object
      description: Grupo de hallazgos de SCA que comparten el mismo nombre de paquete.
      properties:
        package:
          type: object
          properties:
            name:
              type: string
              example: lodash
            ecosystems:
              type: array
              items:
                type: string
              example:
                - npm
        issue_count:
          type: integer
          example: 4
        breakdown:
          $ref: '#/components/schemas/SCAIssueGroupBreakdown'
    SCAIssueGroupBreakdown:
      type: object
      description: Recuentos dentro del grupo; solo se incluyen cuando breakdown es true.
      properties:
        by_severity:
          type: object
          additionalProperties:
            type: integer
          example:
            CRITICAL: 1
            HIGH: 2
            MEDIUM: 1
            LOW: 0
        by_status:
          type: object
          additionalProperties:
            type: integer
          example:
            open: 3
            fixed: 1
            false_positive: 0
            accepted_risk: 0
            duplicate: 0
  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.