---
title: "Fetch a Balance Entry"
method: GET
path: "/balance_entries/{balance_entry_id}"
tags: ["Balances"]
---

# Fetch a Balance Entry

`GET /balance_entries/{balance_entry_id}`

Retrieve the details of a specific `Balance Entry`.

## Headers

- `Finix-Version` string

## Response `200`

A single `Balance`

- BalanceEntry
  - `id` string — The ID of the resource.
  - `created_at` string, date-time — Timestamp of when the object was created.
  - `updated_at` string, date-time — Timestamp of when the object was last updated.
  - `amount` integer — The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
  - `created_by` string — The ID of the application user that created this `Balance Adjustment`.
  - `currency` 'CAD' | 'USD' — ISO 4217 3-letter currency code.
  - `description` string — A description of the `Balance Entry`.
  - `entity_id` string — The ID of the resource that caused the change to the `Balance`, either a `Balance Adjustment` (i.e., "top-up") or a `Transfer`.
  - `entity_type` 'BALANCE_ADJUSTMENT' | 'TRANSFER' — The resource type that caused the change to the `Balance`.
  - `estimated_posted_date` string, date-time — Timestamp estimating when the `Balance Entry` will be posted (i.e., the `state` is set to `SUCCEEDED`).
  - `linked_to` string — The ID of the resource (e.g., an [`Application`](#Application)) that the `Balance Entry` is linked to.
  - `linked_type` 'APPLICATION' — Specifies the type of resource identified in `linked_to`.
  - `parent_balance_entry_id` string — The `parent_balance_entry_id` refers to the ID of the original `Balance Entry`. This is only applicable for transactions that have been reversed after being posted (i.e., the `state` is set to `RETURNED`). For instance, if a transaction with the ID `balance_entry_xyz` is reversed, the newly created reversal entry will have a `parent_balance_entry_id` that matches the ID of the original transaction, `balance_entry_xyz`.
  - `posted_at` string, date-time, nullable — Timestamp of when the `Balance Entry` was posted and finalized on the `Balance` (i.e., state changed to `SUCCEEDED`). This field is `null` if the entry has not been posted.
  - `state` 'SUCCEEDED' | 'PENDING' | 'FAILED' | 'RETURNED' — The current state of the `Balance Entry`. - `SUCCEEDED`: The balance entry has been successfully posted and affects the account balance. - `PENDING`: The balance entry is awaiting confirmation and has not yet affected the account balance. - `FAILED`: The balance entry failed and did not affect the account balance. - `RETURNED`: The balance entry was returned (e.g., due to an ACH return) and has been reversed.
  - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
  - `transaction_date` string, date-time — The date of the transaction.
  - `type` 'BALANCE_TOP_UP_ACH' | 'BALANCE_WITHDRAWAL_ACH' | 'MANUAL_BALANCE_ADJUSTMENT_DECREASE' | 'MANUAL_BALANCE_ADJUSTMENT_INCREASE' | 'PULL_FROM_ACH' | 'PULL_FROM_CARD' | 'PUSH_TO_ACH' | 'PUSH_TO_CARD' | 'PULL_FROM_SAME_DAY_ACH' | 'PUSH_TO_SAME_DAY_ACH' — The transaction type that caused a change to the `Balance`.
  - `wire_details` object — Wire transfer details, if applicable.
    - `external_reference_number` string — External reference number for the wire transfer.
    - `_links` object — An object containing link(s) relevant to the request. You can store these links for follow-up requests.
      - `self` object
        - `href` string — The path to the `Balance Entry` resource.

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)