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

# Listar entregas

> Devuelve el historial de entrega para un endpoint de webhook.

Devuelve los intentos de entrega más recientes para un endpoint de webhook (hasta 50). Utilice esto para monitorear la salud de la entrega, depurar fallos y verificar que los eventos están llegando a su servidor.

### Estados de entrega

| Estado | Descripción |
| :- | :- |
| `pending` | La entrega está en cola y aún no se ha intentado |
| `delivered` | Su endpoint devolvió un código de estado 2xx |
| `failed` | La entrega falló pero puede reintentarse |
| `dead` | Todos los intentos de reintento agotados: la entrega falló permanentemente |

### Campos de respuesta

| Campo | Tipo | Descripción |
| :- | :- | :- |
| `id` | `uuid` | Identificador único para el intento de entrega |
| `endpoint_id` | `uuid` | El endpoint de webhook al que pertenece esta entrega |
| `event_id` | `string` | Identificador único de evento — úselo para deduplicar eventos reintentados |
| `event_type` | `string` | Tipo de evento que activó la entrega (por ejemplo, `attestation.created`) |
| `payload_hash` | `string` | Hash SHA-256 de la carga útil entregada |
| `status` | `string` | Estado de entrega actual: `pending`, `delivered`, `failed`, o `dead` |
| `attempt_count` | `integer` | Número total de intentos de entrega hasta ahora |
| `next_attempt_at` | `string` | Marca de tiempo ISO 8601 del próximo reintento, o `null` si no hay reintentos programados |
| `last_error` | `string` | Mensaje de error del intento fallido más reciente, o `null` si fue exitoso |
| `http_status` | `integer` | Código de estado HTTP devuelto por su endpoint, si está disponible |
| `created_at` | `string` | Marca de tiempo ISO 8601 de cuando la entrega se puso en cola por primera vez |
| `updated_at` | `string` | Marca de tiempo ISO 8601 del cambio de estado más reciente |

### Respuestas

> [!NOTE]
>
> Los resultados están limitados a las 50 entregas más recientes, ordenadas por tiempo de creación (las más nuevas primero). La paginación no es compatible actualmente.


## OpenAPI

````yaml es/mint-openapi.yaml GET /v1/webhooks/endpoints/{id}/deliveries
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/webhooks/endpoints/{id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: Listar entregas de webhook
      description: Devuelve el historial de entrega para un endpoint de webhook.
      operationId: webhooks.endpoints.deliveries
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: ID de punto final de webhook
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: Historial de entregas
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        event_type:
                          type: string
                        status_code:
                          type: integer
                        delivered_at:
                          type: string
                        success:
                          type: boolean
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Código de error legible por máquina
          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: Mensaje de error legible por humanos
        http_status:
          type: integer
          description: Código de estado HTTP
        retry_after_ms:
          type: integer
          description: Milisegundos a esperar antes de reintentar (para límites de tasa)
        details:
          type: object
          description: Contexto de error adicional
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  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.