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

# Listar webhooks da conta

> **Requer token Bearer no header Authorization**.

Retorna todos os webhooks configurados para a conta autenticada.

Cada webhook inclui:
- **id**: Identificador único do webhook
- **type**: Tipo do evento (cash_in, cash_out, refund_in, refund_out)
- **url**: URL do endpoint configurado
- **headers**: Headers customizados
- **isActive**: Status do webhook
- **createdAt**: Data de criação



## OpenAPI

````yaml get /api/webhooks
openapi: 3.0.0
info:
  title: Fire Banking Public API
  description: >-
    API Pública da Plataforma Fire Banking para integração com serviços de
    pagamento PIX e gestão de contas
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.public.firebanking.com.br
    description: Servidor de produção
security: []
tags:
  - name: auth
    description: Endpoints de autenticação
  - name: Balance
    description: Endpoints de consulta de saldo
  - name: PIX
    description: Endpoints de transações PIX
  - name: Webhooks
    description: Endpoints de gerenciamento de webhooks
paths:
  /api/webhooks:
    get:
      tags:
        - Webhooks
      summary: Listar webhooks da conta
      description: |-
        **Requer token Bearer no header Authorization**.

        Retorna todos os webhooks configurados para a conta autenticada.

        Cada webhook inclui:
        - **id**: Identificador único do webhook
        - **type**: Tipo do evento (cash_in, cash_out, refund_in, refund_out)
        - **url**: URL do endpoint configurado
        - **headers**: Headers customizados
        - **isActive**: Status do webhook
        - **createdAt**: Data de criação
      operationId: WebhooksConfigController_listWebhooks
      parameters: []
      responses:
        '200':
          description: Lista de webhooks da conta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWebhooksOutputDto'
        '401':
          description: Token não fornecido ou inválido
        '404':
          description: Conta não encontrada
      security:
        - bearer: []
components:
  schemas:
    ListWebhooksOutputDto:
      type: object
      required:
        - accountId
        - webhooks
        - total
      properties:
        accountId:
          type: number
          description: ID da conta
          example: 93
        webhooks:
          type: array
          description: Lista de webhooks configurados
          items:
            $ref: '#/components/schemas/WebhookItemOutputDto'
        total:
          type: number
          description: Total de webhooks configurados
          example: 4
    WebhookItemOutputDto:
      type: object
      required:
        - id
        - type
        - url
        - headers
        - isActive
        - createdAt
      properties:
        id:
          type: number
          description: Identificador único do webhook
          example: 1
        type:
          type: string
          description: Tipo do evento (cash_in, cash_out, refund_in, refund_out)
          enum:
            - cash_in
            - cash_out
            - refund_in
            - refund_out
          example: cash_in
        url:
          type: string
          description: URL do endpoint que recebe os webhooks
          example: https://api.example.com/webhooks/pix
        headers:
          type: object
          description: Headers customizados configurados (chave-valor)
          additionalProperties:
            type: string
          example:
            Authorization: Bearer token123
        isActive:
          type: boolean
          description: Indica se o webhook está ativo
          example: true
        createdAt:
          type: string
          description: Data de criação do webhook (ISO 8601)
          example: '2025-01-09T12:00:00.000Z'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token

````