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

> Obtiene las detecciones de seguridad de infraestructura como código (IaC) del último escaneo procesado que coincida. 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/iac`, 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/iac
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/iac:
    get:
      tags:
        - Detecciones
        - IaC
      summary: Obtener detecciones de IaC
      description: >-
        Obtiene las detecciones de seguridad de infraestructura como código
        (IaC) del último escaneo procesado que coincida. 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/iac`, el nombre anterior de este
        endpoint, que sigue siendo compatible con los mismos parámetros y la
        misma respuesta.
      operationId: listIacIssues
      parameters:
        - name: project
          in: query
          required: false
          schema:
            type: string
          description: Filtra por nombre de proyecto
        - name: repo
          in: query
          required: false
          schema:
            type: string
          description: Filtra por URL del repositorio
        - name: branch
          in: query
          required: false
          schema:
            type: string
          description: Filtra 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: provider
          in: query
          required: false
          schema:
            type: string
          description: Filtra por proveedor de nube o plataforma
          example: aws
        - name: service
          in: query
          required: false
          schema:
            type: string
          description: Filtra por servicio afectado
          example: s3
        - name: iac_type
          in: query
          required: false
          schema:
            type: string
          description: Filtra por formato de IaC
          example: terraform
        - name: rule_id
          in: query
          required: false
          schema:
            type: string
          description: Filtra por identificador de regla
          example: AVD-AWS-0001
        - name: avd_id
          in: query
          required: false
          schema:
            type: string
          description: Filtra por identificador AVD
          example: AVD-AWS-0001
        - name: path
          in: query
          required: false
          schema:
            type: string
          description: Filtra por ruta de archivo (coincidencia parcial)
          example: infra/main.tf
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: >-
            Busca en el título, la descripción, el mensaje, el ID de regla y el
            ID de AVD
          example: encryption
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - created_at
              - '-created_at'
              - severity
              - '-severity'
              - provider
              - '-provider'
              - service
              - '-service'
              - path
              - '-path'
          description: >-
            Ordena los resultados por campo (antepone '-' para usar el orden
            descendente)
          example: '-severity'
      responses:
        '200':
          description: Hallazgos de IaC 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/IaCIssue'
                  - 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:
    IaCIssue:
      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
        title:
          type: string
        description:
          type: string
        message:
          type: string
        resolution:
          type: string
        severity:
          type: string
          nullable: true
          enum:
            - CRITICAL
            - HIGH
            - MEDIUM
            - LOW
        rule_id:
          type: string
        avd_id:
          type: string
        primary_url:
          type: string
        references:
          type: array
          items: {}
        provider:
          type: string
        service:
          type: string
        iac_type:
          type: string
        location:
          type: object
          properties:
            path:
              type: string
            raw_path:
              type: string
            start_line:
              type: integer
              nullable: true
            end_line:
              type: integer
              nullable: true
        scan:
          type: object
          properties:
            id:
              type: string
              format: uuid
              nullable: true
            branch:
              type: string
              nullable: true
            project:
              type: string
              nullable: true
  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.