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

# Akzeptierte Nutzung und monatliche Rechnungen

> Die akzeptierten Nutzungsklassifizierungen und monatlichen Rechnungsabrechnungen Ihres Arbeitsbereichs lesen.

Erfordert Authentifizierung und gibt nur die Arbeitsbereichsdatensätze des Aufrufers zurück. Dieser Endpunkt generiert, genehmigt oder bezahlt keine Rechnungen.

`usage` enthält bis zu 500 gruppierte Datensätze. Lesen Sie `environment`, `classification`, `quantity`, `currency` und `amount_cents` zusammen. `rated` bedeutet, dass der Preis-Snapshot bei der Abrechnungsannahme beibehalten wurde. Sandbox, kostenlose Pläne, Verbraucherpläne, genehmigte Pilotprojekte und historische Mint-Wiederholungen sind von den Gebühren für die geschäftliche Nutzung ausgeschlossen. Ungelöste Kernpreise oder Umgebungsnachweise halten den Monat zur Überprüfung durch das Personal fest.

`settlements` enthält bis zu 200 monatliche Rechnungsdatensätze, die neuesten zuerst. Eine `DRAFT` ist nicht zahlbar. Das Personal muss die akzeptierte Handelsvereinbarung, Steuern und das Abrechnungsland vor der Ausstellung überprüfen. `automatic_collection` ist für diesen Workflow immer `false`: Das Ausstellen einer Rechnung belastet keine gespeicherte Zahlungsmethode.

Der UTC-Abrechnungsmonat verwendet die Annahmezeit. Bestehende aggregierte Zähler werden nicht rückwirkend in Rechnung gestellt. Verwenden Sie weiterhin denselben Mint-Idempotenzschlüssel, wenn ein Mint meldet, dass sein Abrechnungsbeleg nicht bestätigt werden konnte.

Beträge, die auf `_cents` enden, sind ganze Cents. Die separat abgerufene Rechnung verwendet Währungseinheiten. Zum Beispiel entspricht `amount_cents: 2500` USD 25,00.


## OpenAPI

````yaml de/mint-openapi.yaml GET /v1/billing/usage-settlements
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/billing/usage-settlements:
    get:
      tags:
        - Billing
      summary: Akzeptierte Nutzung und monatliche Rechnungsabrechnungen lesen
      description: >-
        Gibt nur die akzeptierte Nutzung Ihres Arbeitsbereichs und die neuesten
        monatlichen Abrechnungen zurück. Erzeugt keine Rechnungen oder belastet
        Zahlungsmethoden.
      operationId: billing.usageSettlements
      responses:
        '200':
          description: Akzeptierte Nutzung und Abrechnungen
          content:
            application/json:
              schema:
                type: object
                properties:
                  settlements:
                    type: array
                    items:
                      type: object
                  usage:
                    type: array
                    items:
                      type: object
                  settlement_mode:
                    type: string
                    enum:
                      - draft_then_staff_review
                  automatic_collection:
                    type: boolean
                    enum:
                      - false
                  usage_limit:
                    type: integer
                    example: 500
                  settlement_limit:
                    type: integer
                    example: 200
        '401':
          description: Authentifizierung erforderlich
        '503':
          description: Nutzungsdaten sind nicht verfügbar; versuchen Sie es später 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.