> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar webhooks

> Obtiene la lista de webhooks configurados para tu cuenta. Cada webhook define una URL de destino,
eventos suscritos y metadatos para la firma de seguridad.




## OpenAPI

````yaml /api-reference/openapi.yaml get /v2/webhooks
openapi: 3.0.0
info:
  title: Coleccion de API KYB MX
  description: >
    La Colección de API KYB MX proporciona puntos finales para crear y gestionar
    verificaciones de empresas en México. La verificación de empresas implica
    validar la información proporcionada por un cliente comercial, incluyendo
    documentos y fuentes de datos, para asegurar su legitimidad y precisión.


    Cada verificación de empresa puede incluir múltiples ítems, como Actas
    Constitutivas, Constancias de Situación Fiscal, Identificaciones Personales
    y Comprobantes de Domicilio. Trebol maneja automáticamente la clasificación
    de documentos, lo que te permite enviar todos los documentos requeridos como
    URLs descargables (por ejemplo, URLs prefirmadas de AWS o GCP).


    **Autenticación**: 

    La API utiliza una clave API para la autenticación, pasada en el encabezado
    `x-api-key`. Para obtener una clave API, por favor
    [contáctanos](mailto:sales@gotrebol.com).
  version: 1.0.0
servers:
  - url: https://api.gotrebol.com
  - url: http://{{trebol_api_base_url}}
security: []
tags:
  - name: Creacion de Verificacion
    description: Endpoints para crear nuevas verificaciones.
  - name: Leer información de la empresa
    description: >-
      Endpoints v2 para obtener información detallada de empresas y
      verificaciones.
  - name: Leer por Etiqueta
    description: >-
      Endpoints para obtener información detallada sobre empresas mediante
      etiquetas.
  - name: Leer por ID de Verificacion
    description: >-
      Endpoints para obtener información detallada sobre verificaciones mediante
      ID.
  - name: Gestión de IPs Permitidas
    description: >-
      Endpoints para gestionar la lista de IPs permitidas (whitelist) para la
      cuenta del cliente.
  - name: Gestión de API Keys
    description: Endpoints para crear, listar y eliminar API keys de la cuenta del usuario.
  - name: Gestion de item Ids
    description: Endpoints para gestionar items de verificaciones.
  - name: Invalidar un documento
    description: Endpoints para invalidar documentos de verificaciones.
  - name: Labels de Verificacion
    description: Endpoints para gestionar labels de verificaciones.
  - name: Actualizar personas clave de una verificacion
    description: Endpoints para actualizar personas clave de verificaciones.
  - name: Agregar items a una verificacion
    description: Endpoints para agregar items a verificaciones existentes.
  - name: Estado de validacion de documentos
    description: Endpoints para obtener el estado de validación de documentos.
  - name: Gestión de Flujos de Cuenta
    description: Endpoints para gestionar flujos de cuenta.
  - name: Gestión de Webhooks
    description: Endpoints para crear, listar, actualizar y eliminar webhooks de la cuenta.
  - name: Gestión de Política de Retención
    description: Endpoints para gestionar la política de retención de datos de la cuenta.
  - name: Exportación de Verificaciones
    description: >-
      Endpoints para exportar datos de verificaciones a documentos
      personalizados.
  - name: Leer información de la empresa v1
    description: >-
      Endpoints v1 (legacy) para obtener información detallada de empresas y
      verificaciones. Te recomendamos migrar a los endpoints v2.
  - name: Tipos de Ítem Personalizados
    description: >-
      Endpoints para crear y gestionar tipos de ítem personalizados con procesos
      configurables de clasificación, validación y extracción.
paths:
  /v2/webhooks:
    get:
      tags:
        - Gestión de Webhooks
      summary: Listar webhooks
      description: >
        Obtiene la lista de webhooks configurados para tu cuenta. Cada webhook
        define una URL de destino,

        eventos suscritos y metadatos para la firma de seguridad.
      responses:
        '200':
          description: Lista de webhooks obtenida exitosamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  webhooks:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookGet'
              examples:
                Success:
                  summary: Respuesta exitosa
                  value:
                    - id: wh_123
                      url: https://example.com/webhooks/trebol
                      events:
                        - verification.v2.created
                      status: enabled
                      description: Webhook principal de producción
                      created_at: '2025-08-20T10:00:00Z'
                      updated_at: '2025-08-20T10:00:00Z'
        '401':
          description: No autorizado - API key inválida.
        '500':
          description: Error interno del servidor.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    WebhookGet:
      type: object
      properties:
        id:
          type: string
          description: ID único del webhook
          example: wh_123
        url:
          type: string
          format: uri
          description: URL a la que Trebol enviará las notificaciones
          example: https://example.com/webhooks/trebol
        events:
          type: array
          description: Lista de eventos suscritos
          items:
            type: string
            example: verification.v2.created
        status:
          type: string
          enum:
            - enabled
            - disabled
          description: Indica si el webhook está habilitado o deshabilitado
          example: enabled
        description:
          type: string
          nullable: true
          description: Descripción opcional del webhook
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````