> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Risikoereignisexport lesen

> Einen Export abfragen und die abgeschlossenen Nachweise abrufen.

Geben Sie die `export_id` von der Erstellung als Pfadparameter an. Es ist kein Anfragetext erforderlich. Das Polling setzt ausstehende Arbeiten nach einem Neustart fort. Lesen Sie `status`, bevor Sie `export_data` konsumieren; ein fehlgeschlagener Job enthält eine Erklärung. Wenn das Fenster mehr als 10.000 Datensätze enthält, erstellen Sie einen neuen Export mit einem engeren Datumsbereich.

Risikoexporte enthalten Risikosignale und Entscheidungen des Arbeitsbereichs. Sie konfigurieren keine automatische Weiterleitung von Audit-Protokollen. Siehe [SIEM-Integration](https://docs.truthlocks.com/de/guides/siem-integration.md) für den Unterschied.


## OpenAPI

````yaml de/mint-openapi.yaml GET /v1/risk/siem/export/{id}
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/risk/siem/export/{id}:
    get:
      tags:
        - Risk Exports
      summary: Risikoereignisexport lesen
      description: >-
        Einen arbeitsbereichsbezogenen Snapshot lesen; das Abfragen setzt auch
        ausstehende Jobs fort. Mehr als 10000 übereinstimmende Datensätze führen
        explizit zu einem Fehler und erfordern einen engeren Datumsbereich.
        Abgeschlossene Ergebnisse bleiben stabil. Dieser Endpunkt hat keinen
        Anfragetext.
      operationId: audit.siem.get
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: export_id, die bei der Erstellung zurückgegeben wurde
      responses:
        '200':
          description: Aktueller Auftrag und abgeschlossene Nachweise, falls verfügbar
          content:
            application/json:
              schema:
                type: object
                properties:
                  export_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - pending
                      - running
                      - complete
                      - failed
                  format:
                    type: string
                    enum:
                      - json
                      - csv
                      - cef
                      - leef
                  since:
                    type: string
                    format: date-time
                  until:
                    type: string
                    format: date-time
                  event_types:
                    type: array
                    items:
                      type: string
                      enum:
                        - signal
                        - decision
                  record_count:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  completed_at:
                    type: string
                    format: date-time
                  error_message:
                    type: string
                  export_data:
                    description: >-
                      Geparsedte JSON-Beweise für das JSON-Format; Text für CSV,
                      CEF und LEEF. Nur vorhanden, wenn vollständig.
                    oneOf:
                      - type: object
                      - type: array
                        items: {}
                      - type: string
        '400':
          description: Ungültige Exportoptionen oder ID
        '401':
          description: Authentifizierung erforderlich
        '404':
          description: Export in diesem Arbeitsbereich nicht gefunden
        '503':
          description: >-
            Speicherung oder Verarbeitung nicht verfügbar; versuchen Sie es mit
            der vorhandenen Export-ID erneut
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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