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

# Utilisation acceptée et factures mensuelles

> Lire les classifications d'utilisation acceptées de votre espace de travail et les règlements de factures mensuels.

Nécessite une authentification et ne renvoie que les enregistrements de l'espace de travail de l'appelant. Ce point de terminaison ne génère, n'approuve ni ne paie de factures.

`usage` contient jusqu'à 500 enregistrements groupés. Lisez `environment`, `classification`, `quantity`, `currency`, et `amount_cents` ensemble. `rated` signifie que l'instantané des prix a été conservé lors de l'acceptation de la facturation. Le bac à sable, les plans gratuits, les plans consommateurs, les pilotes approuvés et les tentatives de frappe historiques sont exclus des frais d'utilisation commerciale. Les preuves de prix ou d'environnement de base non résolues retiennent le mois pour examen par le personnel.

`settlements` contient jusqu'à 200 enregistrements de factures mensuelles, les plus récents en premier. Une `DRAFT` n'est pas payable. Le personnel doit examiner l'accord commercial accepté, la taxe et le pays de facturation avant l'émission. `automatic_collection` est toujours `false` pour ce flux de travail : l'émission d'une facture ne débite pas un mode de paiement enregistré.

Le mois de facturation UTC utilise l'heure d'acceptation. Les compteurs agrégés existants ne sont pas facturés rétroactivement. Continuez à utiliser la même clé d'idempotence de frappe si une frappe signale que son reçu de facturation n'a pas pu être confirmé.

Les montants se terminant par `_cents` sont des centimes entiers. La facture récupérée séparément utilise des unités monétaires. Par exemple, `amount_cents: 2500` correspond à 25,00 USD.


## OpenAPI

````yaml fr/mint-openapi.yaml GET /v1/billing/usage-settlements
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks est une infrastructure de vérification universelle pour les
    documents, les identifiants et les actifs numériques.

    Cette spécification définit l'API canonique pour interagir avec les services
    Truthlocks.


    ## URL de base

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

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


    ## Authentification

    - **Clés API** : Utilisez l'en-tête `X-API-Key` pour les opérations de
    machine à machine

    - **Jetons Bearer** : Utilisez `Authorization: Bearer <jwt>` pour les
    opérations initiées par l'utilisateur


    ## Identité du locataire

    En production, l'identité du locataire est dérivée du contexte authentifié
    (clé API ou JWT).

    L'en-tête `X-Tenant-ID` est ignoré en production pour éviter l'usurpation
    d'identité.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de production
  - url: https://sandbox-api.truthlocks.com
    description: Environnement de bac à sable
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestion des clés API et des jetons
  - name: Issuers
    description: Enregistrement de l'émetteur et gestion de la confiance
  - name: Keys
    description: Gestion des clés cryptographiques pour les émetteurs
  - name: Attestations
    description: Cycle de vie de l'attestation (créer, révoquer, remplacer)
  - name: Verification
    description: Vérification des attestations et lots de preuves
  - name: Governance
    description: Flux de travail de gouvernance de l'émetteur (administrateur uniquement)
  - name: Identity
    description: Gestion de l'organisation, des utilisateurs et des rôles
  - name: Audit
    description: Requêtes d'événements d'audit
  - name: Tenant Console
    description: Points de terminaison du profil et du cycle de vie du locataire
  - name: Health
    description: Points de terminaison de l'état et de la disponibilité du service
  - name: Risk
    description: Ingestion de signaux de risque et détection de fraude
  - name: Risk Enforcement
    description: >-
      Actions d'application des risques — blocage, défi, quarantaine et
      configuration
  - name: Billing
    description: Gestion de la facturation, des abonnements et des modules complémentaires
  - name: Machine Identity
    description: >-
      Protocole d'identité d'agent machine (MAIP) — enregistrement d'agent,
      sessions, confiance, témoin, conformité, orchestration et observabilité
externalDocs:
  description: API de transparence en lecture seule (spécification de service séparée)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/billing/usage-settlements:
    get:
      tags:
        - Billing
      summary: Lire l'utilisation acceptée et les règlements de factures mensuels
      description: >-
        Retourne uniquement l'utilisation acceptée de votre espace de travail et
        les derniers règlements mensuels. Ne génère pas de factures et ne débite
        pas les méthodes de paiement.
      operationId: billing.usageSettlements
      responses:
        '200':
          description: Utilisation acceptée et règlements
          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: Authentification requise
        '503':
          description: >-
            Les enregistrements d'utilisation ne sont pas disponibles ;
            réessayez plus tard
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clé API pour l'authentification machine-à-machine
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT pour les opérations initiées par l'utilisateur

````

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