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

# IaC-Detections abrufen

> Ruft Infrastructure-as-Code-Security-Detections (IaC) aus dem neuesten passenden verarbeiteten Scan ab. Ohne Scan-ID wird der neueste passende verarbeitete Scan bevorzugt, der das gesamte Projekt abdeckt und keinem PR zugeordnet ist. Fehlt ein solcher Scan, wird der neueste passende Scan verwendet. Ein expliziter Filter scan_type bei /detections oder /detections/code-quality wählt stattdessen den neuesten Scan dieses Typs.

Auch unter `/api/v1/issues/iac` erreichbar, dem früheren Namen dieses Endpunkts, der weiterhin mit denselben Parametern und derselben Antwort unterstützt wird.



## OpenAPI

````yaml /de/api-reference/openapi.json get /detections/iac
openapi: 3.0.0
info:
  title: Corgea API
  version: 1.0.0
  description: >-
    API für die Interaktion mit den Scan- und
    Schwachstellenmanagement-Funktionen von Corgea
servers:
  - url: https://www.corgea.app/api/v1
    description: Produktionsserver
  - url: https://eu.corgea.app/api/v1
    description: EU-Produktionsserver
security:
  - CorgeaToken: []
  - BearerAuth: []
paths:
  /detections/iac:
    get:
      tags:
        - Detections
        - IaC
      summary: IaC-Detections abrufen
      description: >-
        Ruft Infrastructure-as-Code-Security-Detections (IaC) aus dem neuesten
        passenden verarbeiteten Scan ab. Ohne Scan-ID wird der neueste passende
        verarbeitete Scan bevorzugt, der das gesamte Projekt abdeckt und keinem
        PR zugeordnet ist. Fehlt ein solcher Scan, wird der neueste passende
        Scan verwendet. Ein expliziter Filter scan_type bei /detections oder
        /detections/code-quality wählt stattdessen den neuesten Scan dieses
        Typs.


        Auch unter `/api/v1/issues/iac` erreichbar, dem früheren Namen dieses
        Endpunkts, der weiterhin mit denselben Parametern und derselben Antwort
        unterstützt wird.
      operationId: listIacIssues
      parameters:
        - name: project
          in: query
          required: false
          schema:
            type: string
          description: Nach Projektname filtern
        - name: repo
          in: query
          required: false
          schema:
            type: string
          description: Nach Repository-URL filtern
        - name: branch
          in: query
          required: false
          schema:
            type: string
          description: Nach Branch-Name filtern
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Seitennummer für die Paginierung
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 50
          description: Anzahl der Ergebnisse pro Seite
        - name: severity
          in: query
          required: false
          schema:
            type: string
          description: >-
            Nach Schweregraden filtern (kommagetrennt). Gültige Werte: CRITICAL,
            HIGH, MEDIUM, LOW
          example: CRITICAL,HIGH
        - name: provider
          in: query
          required: false
          schema:
            type: string
          description: Nach Cloud- oder Plattform-Provider filtern
          example: aws
        - name: service
          in: query
          required: false
          schema:
            type: string
          description: Nach betroffenem Service filtern
          example: s3
        - name: iac_type
          in: query
          required: false
          schema:
            type: string
          description: Nach IaC-Format filtern
          example: terraform
        - name: rule_id
          in: query
          required: false
          schema:
            type: string
          description: Nach Regelkennung filtern
          example: AVD-AWS-0001
        - name: avd_id
          in: query
          required: false
          schema:
            type: string
          description: Nach AVD-Kennung filtern
          example: AVD-AWS-0001
        - name: path
          in: query
          required: false
          schema:
            type: string
          description: Nach Dateipfad filtern (Teilübereinstimmung)
          example: infra/main.tf
        - name: search
          in: query
          required: false
          schema:
            type: string
          description: Titel, Beschreibung, Meldung, Regel-ID und AVD-ID durchsuchen
          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: >-
            Ergebnisse nach Feld sortieren (für absteigende Reihenfolge ein '-'
            voranstellen)
          example: '-severity'
      responses:
        '200':
          description: IaC-Issues erfolgreich abgerufen oder kein Projekt gefunden
          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: Zugriff verweigert
          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 des Findings, von dem dieses Issue eine Detection ist: über
            Rescans hinweg dieselbe. Null bei einem Issue, das erfasst wurde,
            bevor es Findings gab.
        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: >-
        API-Key für die Authentifizierung API-Tokens inaktiver Benutzer werden
        abgelehnt.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth2-Access-Token (JWT) im Authorization-Header

````

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