# Balance Transactions

Balance transactions are created each time money flows into or out of your Vibrant account. They represent all Payouts, Sales and Refunds including fees.

The source field of a transaction holds a link to the charge, refund or payout that is causing the balance transaction.

Balance Transactions are good for **accounting** as they hold information about all movements to an account. And they hold the fees and payouts as well.

{% hint style="info" %}
Daily revenue

To keep track of 'daily revenue' you do not need to look at balance transactions - we recommend using succeeded Charges and Refunds to get and overview of this. It is possible to fetch this data in custom time intervals that fit the merchants opening/closing hours.
{% endhint %}

It is also possible to use Balance Transaction to get an overview of money that is not transferred to the merchant account yet.

The Balance Transaction will have `status: 'pending'` when payment is approved by the bank until the time of payout. So you can see how much money is pending with Vibrant at any time. 

When the status has changed to `status: 'available'` the money has been transferred (a payout) and the BalanceTransaction is reflected on the merchants bank account.

In rare cases like disputes there will also be created BalanceTransactions to keep track of movements that do not follow the ordinary flow.

You can get balance transactions listed by time, fetched by id or search by attributes.

Get a list of balance transactions like this:

{% tabs %}
{% tab title="curl" %}

```json
curl -X 'GET' \
  'https://pos.dev-api.vibrant.app/pos/v1/balance_transactions' \
  -H 'accept: application/json' \
  -H 'apikey: vibrant_pos.YOUR_SECRET_KEY'
```

{% endtab %}
{% endtabs %}

{% openapi src="/files/ue0EeU2c3jfYIHzrzSXl" path="/pos/v1/balance\_transactions/{id}" method="get" %}
[posapi.json](https://3273535141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHcN7n2RefgutErEy6gSW%2Fuploads%2FC007OnKZIuvAE6rGZWcE%2Fposapi.json?alt=media\&token=03d716fc-96e8-4d36-bcb7-be368305a5a8)
{% endopenapi %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vibrant.io/vibrant/vibrant-sandbox/balance-transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.