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

# Listar webhooks da conta

> **Requer Bearer JWT**.



## OpenAPI

````yaml get /api/webhooks-config
openapi: 3.0.0
info:
  title: NTX Pay Public API — México
  description: >-
    API Pública NTX Pay para integração com SPEI (cash-in/cash-out) no México.
    Todos os valores monetários são expressos em centavos MXN.
  version: 1.0.0
  contact: {}
servers:
  - url: https://sandbox.mx.ntxpay.com
    description: Sandbox
security: []
tags:
  - name: auth
    description: Geração de token via certificado X.509 + clientId/clientSecret
  - name: SPEI
    description: >-
      Transferências interbancárias instantâneas mexicanas (cash-in via CLABE
      descartável; cash-out para CLABE)
  - name: Balance
    description: Consulta de saldo da conta (centavos MXN)
  - name: Webhooks Config
    description: Configuração de webhooks para notificações de eventos
paths:
  /api/webhooks-config:
    get:
      tags:
        - Webhooks Config
      summary: Listar webhooks da conta
      description: '**Requer Bearer JWT**.'
      operationId: WebhooksConfigController_list
      responses:
        '200':
          description: Lista de webhooks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWebhooksOutputDto'
        '401':
          description: Token inválido
      security:
        - bearer: []
components:
  schemas:
    ListWebhooksOutputDto:
      type: object
      properties:
        accountId:
          type: integer
          example: 93
        webhooks:
          type: array
          items:
            $ref: '#/components/schemas/WebhookItemOutputDto'
        total:
          type: integer
          example: 2
    WebhookItemOutputDto:
      type: object
      properties:
        id:
          type: integer
          example: 42
        url:
          type: string
          format: uri
          example: https://example.com/webhooks/mx
        events:
          type: array
          items:
            type: string
            enum:
              - cash_in
              - cash_out
              - refund_in
              - refund_out
              - internal_transfer
          example:
            - cash_in
        isActive:
          type: boolean
          example: true
        createdAt:
          type: string
          format: date-time
          example: '2026-05-01T10:30:00.000Z'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT obtido em POST /api/auth/token

````