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

# List Wallets API

> Retrieve Breezing wallets, exchange accounts, blockchain addresses, and bank accounts to support crypto accounting integrations.



## OpenAPI

````yaml GET /wallets
openapi: 3.1.0
info:
  title: Breezing Public API
  version: 1.0.0
  description: >-
    Crypto accounting API for programmatic access and AI agents. Authenticate
    with an API key using the Authorization header: `Bearer brz_...`
servers:
  - url: https://api.breezing.io/v1
security:
  - BearerAuth: []
paths:
  /wallets:
    get:
      tags:
        - Wallets
      summary: List wallets
      description: >-
        List all wallets for the company. Wallets include blockchain addresses
        (auto-scraped across 40+ chains), exchange accounts (Binance, Kraken,
        etc.), and bank accounts. Each wallet includes name, address, chain,
        exchange identifier, sync status, and transaction count.


        Wallet names are the foundation of categorization context in Breezing.
        They appear as walletFromName/walletToName on transactions, helping
        identify counterparties and transaction purpose. Naming wallet addresses
        is the first step in the categorization workflow.


        When balanceSheetSetup is "wallet" or "wallet-token" (Wallet View /
        Combined View), wallets also drive balance-sheet asset account
        assignment via Rules.


        Use wallet IDs to filter transactions or balances by wallet.
      parameters:
        - schema:
            type: string
            description: >-
              Organization ID. Use GET /v1/companies to discover available
              org/company pairs.
            example: '1'
          required: true
          description: >-
            Organization ID. Use GET /v1/companies to discover available
            org/company pairs.
          name: orgId
          in: query
        - schema:
            type: string
            description: >-
              Company ID. Use GET /v1/companies to discover available companies
              and their access levels.
            example: '1'
          required: true
          description: >-
            Company ID. Use GET /v1/companies to discover available companies
            and their access levels.
          name: companyId
          in: query
      responses:
        '200':
          description: Wallets retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Wallet'
                required:
                  - success
                  - data
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '403':
          description: >-
            API key has no access to this company, has read-only access where
            write was required, or the company subscription is inactive
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
      security:
        - BearerAuth: []
components:
  schemas:
    Wallet:
      type: object
      properties:
        id:
          type: number
          description: Wallet ID
        name:
          type: string
          description: Wallet name
        orgId:
          type: number
          description: Organization ID
        companyId:
          type: number
          description: Company ID
        address:
          type: string
          nullable: true
          description: Wallet address
        exchange:
          type: string
          nullable: true
          description: Exchange name (e.g. binance, kraken)
        bankAccount:
          type: string
          nullable: true
          description: Bank account identifier
        type:
          type: string
          nullable: true
          description: Wallet type
        chain:
          type: string
          nullable: true
          description: Blockchain identifier
          example: eth
        status:
          type: string
          nullable: true
          description: Sync status
        dataFrom:
          type: string
          nullable: true
          description: Data source identifier
        dateFrom:
          type: string
          nullable: true
          description: Sync start date
        dateTo:
          type: string
          nullable: true
          description: Sync end date
        addedTransactions:
          type: number
          nullable: true
          description: Number of synced transactions
        folderId:
          type: number
          nullable: true
          description: Folder ID for organization
        disablePullLatestTrx:
          type: boolean
          description: Whether auto-sync is disabled
        createdAt:
          type: number
          description: Created timestamp (unix ms)
        updatedAt:
          type: number
          description: Updated timestamp (unix ms)
      required:
        - id
        - name
        - orgId
        - companyId
        - address
        - exchange
        - bankAccount
        - type
        - chain
        - status
        - dataFrom
        - dateFrom
        - dateTo
        - addedTransactions
        - folderId
        - disablePullLatestTrx
        - createdAt
        - updatedAt

````