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

# Obtener detecciones de SCA

> Obtiene una lista de detecciones de análisis de composición de software (SCA) Si no se proporciona un ID de escaneo, se prefiere el escaneo procesado más reciente que coincida, cubra todo el proyecto y no pertenezca a un PR. Si no existe, se usa el escaneo más reciente que coincida. Un filtro scan_type explícito en /detections o /detections/code-quality selecciona el escaneo más reciente de ese tipo.

También disponible en `/api/v1/issues/sca`, el nombre anterior de este endpoint, que sigue siendo compatible con los mismos parámetros y la misma respuesta.



## OpenAPI

````yaml /es/api-reference/openapi.json get /detections/sca
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:
  /detections/sca:
    get:
      tags:
        - Detecciones
        - SCA
      summary: Obtener detecciones de SCA
      description: >-
        Obtiene una lista de detecciones de análisis de composición de software
        (SCA) Si no se proporciona un ID de escaneo, se prefiere el escaneo
        procesado más reciente que coincida, cubra todo el proyecto y no
        pertenezca a un PR. Si no existe, se usa el escaneo más reciente que
        coincida. Un filtro scan_type explícito en /detections o
        /detections/code-quality selecciona el escaneo más reciente de ese tipo.


        También disponible en `/api/v1/issues/sca`, el nombre anterior de este
        endpoint, que sigue siendo compatible con los mismos parámetros y la
        misma respuesta.
      operationId: listScaIssues
      parameters:
        - name: project
          in: query
          required: false
          schema:
            type: string
          description: Filtra los hallazgos de SCA por nombre de proyecto
        - name: repo
          in: query
          required: false
          schema:
            type: string
          description: Filtra los hallazgos de SCA por URL del repositorio
        - name: branch
          in: query
          required: false
          schema:
            type: string
          description: Filtra los hallazgos de SCA por nombre de rama
        - 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: 50
          description: Número de resultados por página
        - name: severity
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filtra por niveles de gravedad (valores separados por comas).
            Valores válidos: CRITICAL, HIGH, MEDIUM, LOW
          example: CRITICAL,HIGH
        - name: package
          in: query
          required: false
          schema:
            type: string
          description: Filtra por nombre de paquete (coincidencia parcial)
          example: lodash
        - name: ecosystem
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filtra por ecosistema del paquete (sin distinguir mayúsculas de
            minúsculas)
          example: npm
        - name: cve
          in: query
          required: false
          schema:
            type: string
          description: Filtra por identificador CVE (coincidencia parcial)
          example: CVE-2021
        - name: path
          in: query
          required: false
          schema:
            type: string
          description: Filtra por ruta de archivo (coincidencia parcial)
          example: package.json
        - name: has_fix
          in: query
          required: false
          schema:
            type: boolean
          description: Filtra según haya una corrección disponible (true/false)
          example: true
        - name: reachability
          in: query
          required: false
          schema:
            type: string
            enum:
              - not_direct_dependency
              - pending
              - vulnerable_usage_reachable
              - vulnerable_usage_unreachable
              - dead_dependency
          description: >-
            Filtra los hallazgos de SCA por estado de alcanzabilidad de la
            dependencia
          example: vulnerable_usage_reachable
        - name: include_reachability
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            Incluye el estado y la descripción de alcanzabilidad de la
            dependencia en cada hallazgo de SCA.
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
              - severity
              - '-severity'
              - package
              - '-package'
              - ecosystem
              - '-ecosystem'
          description: >-
            Ordena los resultados por campo (antepone '-' para usar el orden
            descendente)
          example: '-severity'
        - name: status
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filtra por estado de triaje (valores separados por comas). Valores
            válidos: open, fixed, false_positive, accepted_risk, duplicate
          example: open
        - name: package_exact
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filtra por un nombre de paquete exacto. A diferencia de package, no
            coincide con paquetes que solo contienen el valor (lodash no
            coincide con lodash.merge), por lo que es seguro para profundizar en
            un grupo de paquetes.
          example: lodash
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: >-
            Búsqueda de texto libre en el nombre del paquete, el identificador
            CVE, el resumen, los detalles, la ruta y la clasificación
          example: lodash
      responses:
        '200':
          description: Hallazgos de SCA obtenidos correctamente o proyecto no encontrado
          content:
            application/json:
              schema:
                oneOf:
                  - 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/SCAIssue'
                  - type: object
                    properties:
                      status:
                        type: string
                        example: no_project_found
        '403':
          description: Permiso denegado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Permission denied
components:
  schemas:
    SCAIssue:
      type: object
      properties:
        finding_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            ID del finding del que esta incidencia es una detección: el mismo
            entre reescaneos. Null en una incidencia ingerida antes de que
            existieran los findings.
        id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        description:
          type: string
        details:
          type: string
        severity:
          type: string
          nullable: true
          enum:
            - CRITICAL
            - HIGH
            - MEDIUM
            - LOW
          description: >-
            Gravedad informada por el analizador de dependencias, normalmente en
            mayúsculas. Compara los valores sin distinguir entre mayúsculas y
            minúsculas.
        cvss_score:
          type: number
          nullable: true
        classification:
          type: string
          nullable: true
          description: >-
            Clasificación de la amenaza, como malicious, independiente de la
            gravedad. null cuando el hallazgo no tiene clasificación.
        cve:
          type: string
          description: Identificador CVE, si está disponible
        package:
          type: object
          properties:
            name:
              type: string
            version:
              type: string
            ecosystem:
              type: string
            fix_version:
              type: string
              description: Versión que corrige la vulnerabilidad
        location:
          type: object
          properties:
            path:
              type: string
              description: Ruta del archivo que contiene el paquete vulnerable
        reachability:
          $ref: '#/components/schemas/SCAReachability'
    SCAReachability:
      type: object
      properties:
        status:
          type: string
          enum:
            - not_direct_dependency
            - pending
            - vulnerable_usage_reachable
            - vulnerable_usage_unreachable
            - dead_dependency
            - not_applicable
          description: >-
            Estado de alcanzabilidad. not_applicable solo se devuelve al obtener
            un hallazgo de contenedor individual.
        description:
          type: string
  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.