> ## 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.

# Get Balances API

> Retrieve aggregated Breezing balances with wallet and date filters to review token holdings and fiat values in crypto accounting.



## OpenAPI

````yaml GET /balances
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:
  /balances:
    get:
      tags:
        - Balances
      summary: Get aggregated balances
      description: >-
        Get token balances aggregated across all wallets (or a specific wallet
        via walletId). Each balance includes token symbol, total amount, and
        fiat value, all as strings for precision.


        Use dateFrom and dateTo (unix timestamps in seconds) for historical
        balance snapshots, useful for period-end reconciliation: compare these
        balances against block explorer data or exchange statements to verify
        completeness before closing the books. Filter by walletId to check
        individual custody accounts. Omit date filters for current balances.
      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
        - schema:
            type: string
            description: >-
              Filter by wallet ID to see balances for a specific custody
              account. Omit for company-wide balances.
            example: '1'
          required: false
          description: >-
            Filter by wallet ID to see balances for a specific custody account.
            Omit for company-wide balances.
          name: walletId
          in: query
        - schema:
            type: string
            description: >-
              Start of date range (unix timestamp in seconds). Use with dateTo
              for period-end balance snapshots.
            example: '1704067200'
          required: false
          description: >-
            Start of date range (unix timestamp in seconds). Use with dateTo for
            period-end balance snapshots.
          name: dateFrom
          in: query
        - schema:
            type: string
            description: >-
              End of date range (unix timestamp in seconds). Use with dateFrom
              for period-end balance snapshots.
            example: '1735689599'
          required: false
          description: >-
            End of date range (unix timestamp in seconds). Use with dateFrom for
            period-end balance snapshots.
          name: dateTo
          in: query
      responses:
        '200':
          description: Balances retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Balance'
                required:
                  - success
                  - data
        '400':
          description: Invalid request parameters
          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
        '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:
    Balance:
      type: object
      properties:
        token:
          type: string
          description: Token symbol
          example: ETH
        amount:
          type: string
          description: Total token balance (string for precision)
          example: '12.5'
        fiat:
          type: string
          description: Total fiat value (string for precision)
          example: '25000.00'
      required:
        - token
        - amount
        - fiat

````