---
title: "Retrieves a BalanceHistory resource."
method: GET
path: "/balance_histories/{id}"
tags: ["BalanceHistory"]
---

# Retrieves a BalanceHistory resource.

`GET /balance_histories/{id}`

## Request

- Base URL: `https://example.myintranetapps.com/api`
- URL: `https://example.myintranetapps.com/api/balance_histories/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/bossinsights/apis/boss-insights/docs/balance_histories/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a BalanceHistory resource.

## Path parameters

- `id` string, required

## Response `200`

BalanceHistory resource

- BalanceHistory: Balance history represents charges that have contributed to the account balance e.g. charges & transfers
  - `id` string
  - `integration` string: The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string: Unique identifier for balance history
  - `amount` integer: The amount of the transaction
  - `availableOn` string, nullable: The date and time the transaction's net funds will be available in the account balance
  - `created` string: The date and time the transaction was created
  - `currency` string: The currency the transaction was made in
  - `balanceDescription` string, nullable: A description of the transaction
  - `exchangeRate` integer, nullable: The exchange rate represented as a decimal
  - `fee` integer, nullable: The amount of fees paid for the transaction
  - `feeType` string, nullable: The type of fee incurred e.g. "application fee"
  - `net` integer: The net amount of the transaction after deducting all fees, tax and discounts
  - `balanceStatus` string, nullable: Whether the transaction is available in the account balance yet e.g. "available", "pending"
  - `balanceType` string, nullable: The type of transaction e.g. "Charge" e.g. "Refund"

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/bossinsights/apis/boss-insights.md) - [All operations](https://skmtc.dev/bossinsights/apis/boss-insights/llms.txt) - [OpenAPI document](https://skmtc.dev/bossinsights/apis/boss-insights/revisions/d08a107895ad?raw)