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

# Dokumentenverifizierung abrufen

> Rufen Sie den Verifizierungsstatus und das Ergebnis für ein eingereichtes Dokument ab

Gibt den aktuellen Status und die Verifizierungsergebnisse für ein zuvor eingereichtes Dokument zurück. Wenn die Verarbeitung abgeschlossen ist, enthält die Antwort sowohl das KI-Urteil als auch (falls zutreffend) das menschliche Urteil, zusammen mit dem zugehörigen Wahrheitsanspruch und den Beleg-Identifikatoren.

### Authentifizierung

Erfordert `X-API-Key` Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie `X-Tenant-ID` nicht.

### Antwort

**document\_id** `string`

Der Beleg-Verifizierungsdatensatz-Identifikator.

**agent\_id** `string`

Der Agent, der das Dokument eingereicht hat.

**document\_type** `string`

Die Klassifizierung des Dokuments.

**file\_name** `string`

Der ursprüngliche Dateiname.

**document\_hash** `string`

Der SHA-256-Hex-Digest des Dokumentinhalts.

**status** `string`

Aktueller Verarbeitungsstatus. Einer von: - `processing` -- Dokument wird
analysiert – `verified` – Dokument hat die Verifizierung bestanden – `disputed` – Dokument
hat widersprüchliche Signale – `rejected` – Dokument konnte nicht verifiziert werden
(Manipulation, Fälschung oder Ungültigkeit erkannt)

**ai\_verdict** `string`

Die Bestimmung des KI-Modells. Eine von: `authentic`, `suspicious`, `forged`.
`inconclusive`. `null`, während die Verarbeitung noch läuft.

**ai\_confidence** `number`

Die Zuverlässigkeit des KI-Modells in seinem Urteil als Gleitkommazahl zwischen `0.0` und `1.0`.
`null`, während die Verarbeitung noch läuft.

**human\_verdict** `string`

Die Bestimmung des menschlichen Prüfers, falls eine menschliche Prüfung ausgelöst wurde. Eine von:
`authentic`, `suspicious`, `forged`, `inconclusive`. `null`, falls noch nicht
überprüft oder eine menschliche Überprüfung war nicht erforderlich.

**truth\_claim\_id** `string`

Der Bezeichner des Wahrheitsanspruchs, der automatisch für dieses Dokument erstellt wurde
Verifizierung. Format: `maip-tc:ULID`.

**receipt\_ids** `string[]`

Liste der während des Verifizierungsprozesses geprägten Beleg-Identifikatoren. Typischerweise
enthält den Verifizierungsbeleg und, falls zutreffend, die menschliche Überprüfung
Quittung.

**created\_at** `string`

ISO 8601 Zeitstempel, wann das Dokument eingereicht wurde.

**updated\_at** `string`

ISO 8601 Zeitstempel der letzten Statusänderung.


## OpenAPI

````yaml de/mint-openapi.yaml GET /v1/truth/document/{documentId}
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/truth/document/{documentId}:
    get:
      tags:
        - Machine Identity
      summary: Dokumentenverifizierung abrufen
      description: >-
        Gibt den vollständigen Verifizierungsdatensatz für ein Dokument
        einschließlich aller zugehörigen Ansprüche zurück.
      operationId: maip.truth.document.get
      parameters:
        - name: documentId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Identifikator der Dokumentenprüfung
      responses:
        '200':
          description: Details zur Dokumentenprüfung
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipDocumentVerification'
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Dokument nicht gefunden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Ratenlimit überschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipDocumentVerification:
      type: object
      properties:
        verification_id:
          type: string
          format: uuid
        document_id:
          type: string
          format: uuid
        document_hash:
          type: string
        status:
          type: string
          enum:
            - pending
            - verified
            - failed
        results:
          type: array
          items:
            type: object
            additionalProperties: true
        verifications:
          type: array
          items:
            type: object
            additionalProperties: true
        claims:
          type: array
          items:
            $ref: '#/components/schemas/MaipTruthClaim'
        created_at:
          type: string
          format: date-time
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Maschinenlesbarer Fehlercode
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
    MaipTruthClaim:
      type: object
      properties:
        claim_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        claim_type:
          type: string
        payload:
          type: object
          additionalProperties: true
        evidence:
          type: array
          items:
            type: object
            additionalProperties: true
        status:
          type: string
          enum:
            - pending
            - verified
            - rejected
            - expired
        receipt_id:
          type: string
          format: uuid
        attestations:
          type: array
          items:
            $ref: '#/components/schemas/MaipAttestation'
        verified_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
    MaipAttestation:
      type: object
      properties:
        attestation_id:
          type: string
          format: uuid
        witness_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        claim_hash:
          type: string
        signature:
          type: string
        status:
          type: string
          enum:
            - pending
            - accepted
            - rejected
        created_at:
          type: string
          format: date-time
  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.