---
title: "Retrieve Business Balance"
method: GET
path: "/wallet"
---

# Retrieve Business Balance

`GET /wallet`

Get main account balance

## Headers

- `org_wallet_ref` integer

## Response `200`

Successful response

- StatementResponse
  - `docs` StatementEntry[]
    - `_id` string
    - `currency` string
    - `org_wallet_ref` string
    - `account` string
    - `credit` number
    - `debit` number
    - `counter` integer
    - `description` string
    - `ref` string
    - `created_by` string
    - `transaction_type` 'EXPENSE' | 'TOPUP' | 'REFUND' | 'REVERSAL'
    - `running_balance` number
    - `business_running_balance` number
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `expense` Expense
      - `_id` string
      - `amount` number
      - `fees` number
      - `charge` number
      - `original_currency` string
      - `currency` string
      - `original_amount` number
      - `transaction_ref` string
      - `provider_ref` string
      - `employee_id` string
      - `person` string
      - `transaction_date` string, date-time
      - `MerchantCategoryCode` string
      - `MerchantIdentifier` string
      - `fx_rate` number
      - `card_vcn` string
      - `receiver` string
      - `payment_type` string
      - `channel` string
      - `subcategory` object, nullable
      - `team` object
        - `_id` string
        - `name` string
        - `code` string
      - `tag` string[]
      - `notes` string
      - `risk` string
      - `risk_notes` string
      - `attachments` string[]
      - `payment_status` string
      - `status` string
      - `review_participants` string[]
      - `review_mandate` integer
      - `review_level` integer
      - `events` object[]
      - `exported` boolean
      - `sync_successful` boolean
      - `org_wallet_ref` string
      - `vendor` string
      - `customer` object, nullable
      - `subscription_id` string
      - `account_number` string
      - `reviews` object[]
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `topup` Topup
      - `_id` string
      - `ref` string
      - `description` string
      - `amount` number
      - `account` string
      - `channel` string
      - `is_employee_topup` boolean
      - `exported` boolean
      - `sync_successful` boolean
      - `created_by` string
      - `status` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `refund` Refund
      - `_id` string
      - `ref` string
      - `transaction_ref` string
      - `description` string
      - `amount` number
      - `account` string
      - `employee_id` string
      - `status` string
      - `org_wallet_ref` string
      - `currency` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
  - `total` integer
  - `limit` string
  - `page` string
  - `pages` integer

## Changes

- **2026-08-14** `7cb66a3891c2` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Change history](https://skmtc.dev/boyahq/apis/boya-statement-api/changes/wallet/get.md)

---

[API](https://skmtc.dev/boyahq/apis/boya-statement-api.md) · [All operations](https://skmtc.dev/boyahq/apis/boya-statement-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boyahq/boya-statement-api/revisions/7cb66a3891c2/schema)