> ## Documentation Index > Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt > Use this file to discover all available pages before exploring further. # Fetch Balance Transaction > 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 ## OpenAPI ````yaml get /v3/balance_transaction/{id} openapi: 3.1.0 info: title: sandbox version: '3' servers: - url: https://service-sandbox.tazapay.com security: - sec0: [] paths: /v3/balance_transaction/{id}: get: summary: Fetch Balance Transaction description: >- 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 operationId: fetch-balance-transaction parameters: - name: id in: path description: ID of the balance transaction you want to expand schema: type: string required: true responses: '200': description: '200' content: application/json: examples: escrow: summary: escrow value: status: success message: '' data: amount: 10000 created_at: '2025-07-04T08:38:20.564Z' currency: INR description: pat_d1jp5tgf3uhv3dumbkd0 fee_details: - amount: -180 currency: INR type: variable_fee fx_conversions: - exchange_rate: 0.010869823862581245 final: amount: 107 currency: USD initial: amount: 9820 currency: INR id: btr_d1jp5v0f3uhv3dumbkhg metadata: {} net: amount: 107 currency: USD object: balance_transaction operation_type: credit source: esc_d1jp5pof3uhv3dumbjcg type: escrow payin: summary: payin value: status: success message: '' data: amount: 10000 created_at: '2025-07-04T09:02:40.311Z' currency: THB description: pat_d1jpgsof3uhv3dumcc4g fee_details: - amount: -180 currency: THB type: variable_fee fx_conversions: - exchange_rate: 0.029381528136882128 final: amount: 289 currency: USD initial: amount: 9820 currency: THB id: btr_d1jphc0f3uhv3dumceu0 metadata: {} net: amount: 289 currency: USD object: balance_transaction operation_type: credit source: pay_d1jpgsof3uhv3dumcc2g type: payin payout: summary: payout value: status: success message: '' data: amount: -100000 created_at: '2025-07-04T09:08:31.487Z' currency: INR description: '' fee_details: - amount: -500 currency: USD type: fixed_fee fx_conversions: - exchange_rate: 89.16538295208768 final: amount: -44583 currency: INR initial: amount: -500 currency: USD - exchange_rate: 96.55501288867562 final: amount: -1497 currency: EUR initial: amount: -144583 currency: INR id: btr_d1jpk38qm9cnvqjgn7e0 metadata: {} net: amount: -1497 currency: EUR object: balance_transaction operation_type: debit source: pot_d1jpk30qm9cnvqjgn7a0 type: payout refund: summary: refund value: status: success message: '' data: amount: 10000 created_at: '2025-07-04T08:38:20.564Z' currency: INR description: pat_d1jp5tgf3uhv3dumbkd0 fee_details: - amount: -180 currency: INR type: variable_fee fx_conversions: - exchange_rate: 0.010869823862581245 final: amount: 107 currency: USD initial: amount: 9820 currency: INR id: btr_d1jp5v0f3uhv3dumbkhg metadata: {} net: amount: 107 currency: USD object: balance_transaction operation_type: credit source: esc_d1jp5pof3uhv3dumbjcg type: escrow collect: summary: collect value: status: success message: '' data: amount: 5200000 created_at: '2025-07-08T11:12:56.169Z' currency: CAD description: '' fee_details: - amount: -500 currency: USD type: fixed_fee - amount: -52000 currency: CAD type: variable_fee fx_conversions: - exchange_rate: 1.3781458880363453 final: amount: -689 currency: CAD initial: amount: -500 currency: USD id: btr_d1mfqdrgbjuuovultnu0 metadata: {} net: amount: 5147311 currency: CAD object: balance_transaction operation_type: credit source: col_d1mfqcbgbjuuovultmp0 type: collect checkout: value: status: success message: '' data: amount: 10000 created_at: '2025-07-04T08:43:06.897Z' currency: MXN description: pat_d1jp85of3uhv3dumbp80 fee_details: - amount: -180 currency: MXN type: variable_fee fx_conversions: - exchange_rate: 0.05031085313964386 final: amount: 494 currency: USD initial: amount: 9820 currency: MXN id: btr_d1jp86gf3uhv3dumbpe0 metadata: {} net: amount: 494 currency: USD object: balance_transaction operation_type: credit source: chk_d1jp7s0f3uhv3dumbo70 type: checkout summary: checkout refund reversal: summary: refund reversal value: status: success message: '' data: amount: 1000 created_at: '2025-08-27T05:17:25.347Z' currency: USD description: rfd_d2n99fsa2ukiaipjkopg fee_details: [] fx_conversions: [] id: btr_d2n99p9qiuj7t9e8tcvg metadata: {} net: amount: 1000 currency: USD object: balance_transaction operation_type: credit source: btr_d2n99fsa2ukiaipjkoq0 type: refund_reversal payout reversal: summary: payout reversal value: status: success message: '' data: amount: 140847 created_at: '2025-12-19T09:11:00.604Z' currency: USD description: pot_d52grubk90bi91v246s0 fee_details: - amount: 1000000 currency: INR type: fixed_fee fx_conversions: - exchange_rate: 8.4682 final: amount: 140847 currency: HKD initial: amount: 16632 currency: USD - exchange_rate: 0.012007 final: amount: 12007 currency: USD initial: amount: 1000000 currency: INR id: btr_d52hd93k90bi91v2493g metadata: {} net: amount: 4625 currency: USD object: balance_transaction operation_type: credit source: btr_d52grubk90bi91v246vg type: payout_reversal schema: type: object properties: status: type: string description: >- Indicates whether the balance transaction retrieval was successful. message: type: string description: Additional message or information about the response. data: type: object description: Details of the balance transaction. properties: amount: type: integer description: >- Total transaction amount in the smallest currency unit. A negative value represents a debit. created_at: type: string description: >- Timestamp when the balance transaction was created (ISO 8601 format). currency: type: string description: >- Currency of the balance transaction, in ISO 4217 format. description: type: string description: >- Description or memo associated with the balance transaction. fee_details: type: array description: Details of fees applied to this balance transaction. items: type: object properties: amount: type: integer description: >- Fee amount applied, in the smallest currency unit. A negative value indicates deduction. currency: type: string description: Currency in which the fee was charged. type: type: string description: >- Type of fee applied (e.g., fixed_fee, variable_fee). fx_conversions: type: array description: >- Details of foreign exchange conversions applied within this transaction. items: type: object properties: exchange_rate: type: number description: Exchange rate applied for this FX conversion. final: type: object description: Final converted amount details. properties: amount: type: integer description: >- Final converted amount in smallest currency unit. currency: type: string description: Final currency after conversion. initial: type: object description: Original amount before conversion. properties: amount: type: integer description: >- Initial amount before conversion in smallest currency unit. currency: type: string description: Initial currency before conversion. id: type: string description: Unique identifier for the balance transaction. metadata: $ref: '#/components/schemas/Metadata' net: type: object description: Net amount after fees and FX adjustments. properties: amount: type: integer description: >- Net amount after fees and FX conversions, in smallest currency unit. currency: type: string description: Currency of the net balance after all adjustments. object: type: string description: >- Type of object represented, typically 'balance_transaction'. operation_type: type: string description: >- Indicates whether the balance transaction is a credit or debit. source: type: string description: >- ID of the source object (e.g., payout, payin) linked to this balance transaction. type: type: string description: >- Specifies the transaction type, such as payout, payin, or refund. '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: Metadata: type: object description: Custom metadata key-value pairs attached to the object additionalProperties: type: string nullable: true ErrorResponse: type: object description: Standard error response structure properties: status: type: string enum: - error description: Always 'error' for error responses message: type: string description: High-level error message errors: type: array description: Array of detailed error objects items: type: object properties: code: type: integer description: Specific error code message: type: string description: Detailed error message remarks: type: string description: Additional context or suggestions for resolution securitySchemes: sec0: type: http scheme: basic ````