---
title: "Fetch Balance Transaction"
method: GET
path: "/v3/balance_transaction/{id}"
---

# Fetch Balance Transaction

`GET /v3/balance_transaction/{id}`

Provides real-time, detailed insights into individual balance movements, including charges, currency conversions, and adjustments, allowing you to track all credits and debits across multiple currencies

## Path parameters

- `id` string, required

## Response `200`

200

- object
  - `status` string — Indicates whether the balance transaction retrieval was successful.
  - `message` string — Additional message or information about the response.
  - `data` object — Details of the balance transaction.
    - `amount` integer — Total transaction amount in the smallest currency unit. A negative value represents a debit.
    - `created_at` string — Timestamp when the balance transaction was created (ISO 8601 format).
    - `currency` string — Currency of the balance transaction, in ISO 4217 format.
    - `description` string — Description or memo associated with the balance transaction.
    - `fee_details` object[] — Details of fees applied to this balance transaction.
      - `amount` integer — Fee amount applied, in the smallest currency unit. A negative value indicates deduction.
      - `currency` string — Currency in which the fee was charged.
      - `type` string — Type of fee applied (e.g., fixed_fee, variable_fee).
    - `fx_conversions` object[] — Details of foreign exchange conversions applied within this transaction.
      - `exchange_rate` number — Exchange rate applied for this FX conversion.
      - `final` object — Final converted amount details.
        - `amount` integer — Final converted amount in smallest currency unit.
        - `currency` string — Final currency after conversion.
      - `initial` object — Original amount before conversion.
        - `amount` integer — Initial amount before conversion in smallest currency unit.
        - `currency` string — Initial currency before conversion.
    - `id` string — Unique identifier for the balance transaction.
    - `metadata` Metadata, nullable — Custom metadata key-value pairs attached to the object
    - `net` object — Net amount after fees and FX adjustments.
      - `amount` integer — Net amount after fees and FX conversions, in smallest currency unit.
      - `currency` string — Currency of the net balance after all adjustments.
    - `object` string — Type of object represented, typically 'balance_transaction'.
    - `operation_type` string — Indicates whether the balance transaction is a credit or debit.
    - `source` string — ID of the source object (e.g., payout, payin) linked to this balance transaction.
    - `type` string — Specifies the transaction type, such as payout, payin, or refund.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/revisions/bf5f4b8f6f5d/schema)