The Get Multi-Currency Account Balance API provides real-time visibility into the financial position of a specific provisioned account. By utilizing the unique currency_account_urn, clients can fetch the available balance.

Request Specifications

Endpoint:

GET /v2/payments/currency_account/balance

Parameter	Type	In	Description	Required
`currency_account_urn`	String	Query	The unique URN of the account generated during the creation process.	Yes
`reference_id`	String	Query	A unique reference ID for tracking the inquiry and ensuring idempotency.	Yes

Response Specifications

The response provides the current balance details mapped to the specific account identifier.

Field Path	Type	Description
`decentro_txn_id`	String	Unique Decentro transaction identifier for the request.
`status`	String	Status of the API request (e.g., SUCCESS).
`data.currency_account_urn`	String	The URN of the account being queried.
`data.currency`	String	ISO currency code (e.g., USD, EUR).
`data.amount`	String	The current available balance in the major currency unit.
`response_key`	String	Machine-readable key for programmatic logic.