> ## 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 hallazgos de calidad del código

> Obtiene los hallazgos de calidad del código por separado de los hallazgos de seguridad. Los valores de clasificación son etiquetas de calidad del código, como Maintainability, en lugar de CWE.



## OpenAPI

````yaml /es/api-reference/openapi.json get /issues/code-quality
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
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /issues/code-quality:
    get:
      tags:
        - Hallazgos
      summary: Listar hallazgos de calidad del código
      description: >-
        Obtiene los hallazgos de calidad del código por separado de los
        hallazgos de seguridad. Los valores de clasificación son etiquetas de
        calidad del código, como Maintainability, en lugar de CWE.
      operationId: listCodeQualityIssues
      parameters:
        - name: project
          in: query
          schema:
            type: string
          description: Filtra los hallazgos por nombre de proyecto
        - name: repo
          in: query
          schema:
            type: string
          description: Filtra los hallazgos por URL del repositorio
        - name: branch
          in: query
          schema:
            type: string
          description: Filtra los hallazgos por nombre de rama
        - name: classification
          in: query
          schema:
            type: string
          description: >-
            Filtra por etiqueta de clasificación de calidad del código
            (coincidencia parcial)
          example: Maintainability
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          schema:
            type: integer
            default: 20
            maximum: 50
      responses:
        '200':
          description: Hallazgos de calidad del código obtenidos correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
                  page:
                    type: integer
                  total_pages:
                    type: integer
                  total_issues:
                    type: integer
                  issues:
                    type: array
                    items:
                      $ref: '#/components/schemas/Issue'
components:
  schemas:
    Issue:
      type: object
      properties:
        id:
          type: string
          format: uuid
        classification:
          type: object
          properties:
            id:
              type: string
              example: CWE-123
            name:
              type: string
              example: Vulnerability Name
            description:
              type: string
              nullable: true
        urgency:
          type: string
          enum:
            - critical
            - high
            - medium
            - low
        created_at:
          type: string
          format: date-time
        status:
          type: string
          enum:
            - open
            - in_progress
            - fixed
            - accepted_risk
            - false_positive
        sla_status:
          type: string
          enum:
            - on_track
            - due
            - overdue
        location:
          $ref: '#/components/schemas/IssueLocation'
        auto_triage:
          $ref: '#/components/schemas/AutoTriage'
        auto_fix_suggestion:
          $ref: '#/components/schemas/AutoFixSuggestion'
        assigned_to:
          $ref: '#/components/schemas/AssignedTo'
        scanner_metadata:
          type: object
          description: Metadatos proporcionados por el escáner y asociados al hallazgo.
          additionalProperties:
            type: string
        reachability:
          $ref: '#/components/schemas/IssueReachabilitySummary'
    IssueLocation:
      type: object
      properties:
        file:
          type: object
          properties:
            name:
              type: string
            language:
              type: string
            path:
              type: string
        project:
          type: object
          properties:
            name:
              type: string
            branch:
              type: string
            git_sha:
              type: string
        line_number:
          type: integer
    AutoTriage:
      type: object
      properties:
        false_positive_detection:
          type: object
          properties:
            status:
              type: string
              enum:
                - valid
                - false_positive
                - pending
            reasoning:
              type: string
    AutoFixSuggestion:
      type: object
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - fix_available
            - no_fix
            - false_positive
            - on_hold
            - unsupported
            - plan
          description: >-
            Disponibilidad actual de la corrección. De forma predeterminada, una
            solicitud para obtener un hallazgo genera la corrección que falte si
            cumple los requisitos; si la generación está desactivada o no se
            genera ninguna corrección, el estado es no_fix.
        patch:
          type: object
          properties:
            diff:
              type: string
              description: Parche en formato diff unificado
            explanation:
              type: string
              description: Explicación de cómo la corrección resuelve la vulnerabilidad
    AssignedTo:
      type: object
      nullable: true
      description: >-
        Usuario asignado al hallazgo, o null cuando el hallazgo no está
        asignado.
      properties:
        id:
          type: string
          description: ID del usuario asignado.
        email:
          type: string
          format: email
          description: Dirección de correo electrónico del usuario asignado.
        name:
          type: string
          nullable: true
          description: >-
            Nombre para mostrar del usuario asignado, o null si no está
            disponible.
    IssueReachabilitySummary:
      type: object
      description: >-
        Resumen de alcanzabilidad de endpoints que se devuelve cuando
        include_reachability es true.
      properties:
        is_reachable:
          type: boolean
        endpoint_count:
          type: integer
  securitySchemes:
    CorgeaToken:
      type: apiKey
      in: header
      name: CORGEA-TOKEN
      description: Clave de API para la autenticación
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token de acceso OAuth2 (JWT) en el encabezado Authorization

````