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

# Listar contas bancárias

> Lista todas as contas bancárias cadastradas para a empresa. A resposta inclui informações detalhadas de cada conta, como dados do titular, dados bancários e status da conta. Os resultados são paginados para melhor performance.

**Operação em subconta:**
Para listar as contas bancárias de uma subconta específica, inclua o header `x-subaccount-id` com o ID da subconta. Quando este header é fornecido, a operação será realizada no contexto da subconta especificada, em vez da conta principal autenticada.



## OpenAPI

````yaml GET /bank_accounts
openapi: 3.1.0
info:
  title: OpenAPI Super APIs
  description: Documentação das APIs destinada a companhias da Super Pagamentos
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox-api.superpagamentos.com
    description: Ambiente de desenvolvimento
  - url: https://api.superpagamentos.com
    description: Ambiente de produção
security: []
paths:
  /bank_accounts:
    get:
      description: >-
        Lista todas as contas bancárias cadastradas para a empresa. A resposta
        inclui informações detalhadas de cada conta, como dados do titular,
        dados bancários e status da conta. Os resultados são paginados para
        melhor performance.


        **Operação em subconta:**

        Para listar as contas bancárias de uma subconta específica, inclua o
        header `x-subaccount-id` com o ID da subconta. Quando este header é
        fornecido, a operação será realizada no contexto da subconta
        especificada, em vez da conta principal autenticada.
      parameters:
        - name: x-subaccount-id
          in: header
          description: >-
            ID da subconta onde a operação será realizada. Quando fornecido, a
            operação será executada no contexto desta subconta específica.
          required: false
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: Número da página que deseja visualizar
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: limit
          in: query
          description: Quantidade de itens por página
          required: false
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: Listagem de contas bancárias
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/listBankAccountsResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    listBankAccountsResponse:
      type: object
      properties:
        data:
          description: Lista de contas bancárias
          type: array
          items:
            type: object
            properties:
              id:
                description: Identificador único da conta bancária
                type: integer
                example: 1237864
              holderName:
                description: Nome do beneficiário da conta
                type: string
                example: Empresa Teste LTDA
              bankCode:
                description: Código do banco
                type: string
                example: '001'
              routingNumber:
                description: Número da agência com dígito verificador
                type: string
                example: 0001-00
              accountNumber:
                description: Número da conta com dígito verificador
                type: string
                example: 12345678-00
              document:
                description: CPF ou CNPJ do beneficiário da conta
                type: string
                example: '59163721000165'
              accountType:
                description: Tipo da conta bancária
                type: string
                example: CHECKING
              status:
                description: Status atual da conta bancária
                type: string
                example: APPROVED
              createdAt:
                description: Data e hora de criação da conta bancária
                type: string
                format: date-time
                example: '2025-05-15T20:54:35.106Z'
        meta:
          description: Dados de paginação
          type: object
          properties:
            total:
              description: Total de contas bancárias cadastradas
              type: integer
              example: 11
            page:
              description: Página atual da listagem
              type: integer
              example: 1
            limit:
              description: Quantidade de itens por página
              type: integer
              example: 10
            totalPages:
              description: Total de páginas disponíveis
              type: integer
              example: 2
        message:
          type: string
          example: Listagem de contas bancárias
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no
        formato: Bearer <token>

````