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

# Uso aceptado y facturas mensuales

> Leer las clasificaciones de uso aceptadas de su espacio de trabajo y las liquidaciones de facturas mensuales.

Requiere autenticación y devuelve solo los registros del espacio de trabajo del llamador. Este endpoint no genera, aprueba ni paga facturas.

`usage` contiene hasta 500 registros agrupados. Lea `environment`, `classification`, `quantity`, `currency` y `amount_cents` juntos. `rated` significa que la instantánea de precios se conservó en la aceptación de la facturación. Los planes sandbox, gratuitos, planes de consumidor, pilotos aprobados y reintentos de acuñación históricos están excluidos de los cargos por uso comercial. Los precios centrales no resueltos o la evidencia del entorno retienen el mes para la revisión del personal.

`settlements` contiene hasta 200 registros de facturas mensuales, los más recientes primero. Una `DRAFT` no es pagadera. El personal debe revisar el acuerdo comercial aceptado, los impuestos y el país de facturación antes de emitir. `automatic_collection` siempre es `false` para este flujo de trabajo: la emisión de una factura no carga un método de pago guardado.

El mes de facturación UTC utiliza la hora de aceptación. Los contadores agregados existentes no se facturan retroactivamente. Continúe utilizando la misma clave de idempotencia de acuñación si una acuñación informa que su recibo de facturación no pudo confirmarse.

Las cantidades que terminan en `_cents` son centavos enteros. La factura recuperada por separado utiliza unidades monetarias. Por ejemplo, `amount_cents: 2500` corresponde a USD 25.00.


## OpenAPI

````yaml es/mint-openapi.yaml GET /v1/billing/usage-settlements
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks es una infraestructura de verificación universal para documentos,
    credenciales y activos digitales.

    Esta especificación define la API canónica para interactuar con los
    servicios de Truthlocks.


    ## URLs Base

    - **Producción**: `https://api.truthlocks.com`

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


    ## Autenticación

    - **Claves API**: Use el encabezado `X-API-Key` para operaciones máquina a
    máquina

    - **Tokens Bearer**: Use `Authorization: Bearer <jwt>` para operaciones
    iniciadas por el usuario


    ## Identidad del Inquilino

    En producción, la identidad del inquilino se deriva del contexto autenticado
    (clave API o JWT).

    El encabezado `X-Tenant-ID` se ignora en producción para evitar la
    suplantación de identidad.
  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 producción
  - url: https://sandbox-api.truthlocks.com
    description: Entorno Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestión de claves y tokens de API
  - name: Issuers
    description: Registro del emisor y gestión de la confianza
  - name: Keys
    description: Gestión de claves criptográficas para emisores
  - name: Attestations
    description: Ciclo de vida de la atestación (acuñar, revocar, reemplazar)
  - name: Verification
    description: Verificación de atestación y paquetes de prueba
  - name: Governance
    description: Flujos de trabajo de gobernanza del emisor (solo administrador)
  - name: Identity
    description: Gestión de organización, usuarios y roles
  - name: Audit
    description: Consultas de eventos de auditoría
  - name: Tenant Console
    description: Puntos finales de perfil y ciclo de vida del inquilino
  - name: Health
    description: Endpoints de estado y preparación del servicio
  - name: Risk
    description: Ingesta de señales de riesgo y detección de fraude
  - name: Risk Enforcement
    description: >-
      Acciones de aplicación de riesgos: bloqueo, desafío, cuarentena y
      configuración
  - name: Billing
    description: Gestión de facturación, suscripciones y complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidad de Agente de Máquina (MAIP) — registro de agentes,
      sesiones, confianza, testigo, cumplimiento, orquestación y observabilidad
externalDocs:
  description: API de transparencia de solo lectura (especificación de servicio separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/billing/usage-settlements:
    get:
      tags:
        - Billing
      summary: Leer uso aceptado y liquidaciones de facturas mensuales
      description: >-
        Devuelve solo el uso aceptado de su espacio de trabajo y los últimos
        acuerdos mensuales. No genera facturas ni cobra métodos de pago.
      operationId: billing.usageSettlements
      responses:
        '200':
          description: Uso aceptado y liquidaciones
          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: Autenticación requerida
        '503':
          description: >-
            Los registros de uso no están disponibles; inténtelo de nuevo más
            tarde
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave API para autenticación máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operaciones iniciadas por el usuario

````

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