--- title: "Get an Account" method: GET path: "/api/accounts/{id}" tags: ["Accounts"] --- # Get an Account `GET /api/accounts/{id}` Get an Account identified by the provided ID. ## Path parameters - `id` string, uuid, required ## Headers - `on-behalf-of` string ## Response `200` Mural Account - Account - `accountDetails` MuralAccountDetails - `balancesV2` union[], required — The balances associated with the Account, including both blockchain token balances and fiat balances. - union - BlockchainAmount - `type` 'blockchain', required - `tokenSymbol` 'USDC' | 'USDT', required — The token symbol. - `exponent` number, required — The number of decimal places used by the smallest unit of the token. - `value` string, required — The token amount in its smallest unit, as a string to preserve precision. - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA', required — The blockchain network on which the token lives. - FiatAmount - `type` 'fiat', required - `currencySymbol` 'USD', required — The ISO 4217 currency code. - `exponent` number, required — The number of decimal places used by the smallest unit of the currency. - `value` string, required — The amount in the smallest unit of the currency, as a string to preserve precision (e.g., for USD with exponent 2, "2500" represents $25.00). - `depositAccount` DepositAccount - `bankAccountNumber` string, required - `bankAddress` string, required - `bankBeneficiaryAddress` string, required - `bankBeneficiaryName` string, required - `bankName` string, required - `bankRoutingNumber` string, required - `currency` 'USD' | 'COP' | 'ARS' | 'EUR' | 'MXN' | 'BRL' | 'CLP' | 'PEN' | 'BOB' | 'CRC' | 'ZAR', required - `id` string, uuid, required - `paymentRails` string[], required - `status` 'ACTIVATED' | 'DEACTIVATED', required - `payinMethods` PayinMethod[], required — The payin methods for the Account. - `payinRailDetails` union, required - USDPayinRailDetails - `bankAccountNumber` string, required - `bankAccountType` 'CHECKING' | 'SAVINGS', required — The type of bank account (checking or savings). - `bankAddress` string, required - `bankBeneficiaryAddress` string, required - `bankBeneficiaryName` string, required - `bankName` string, required - `bankRoutingNumber` string, required - `currency` 'USD', required - `payinRails` string[], required - `settlementStrategy` union, required — The settlement strategy for this payin method. Controls whether incoming funds are held as fiat or automatically on-ramped to the Account destination token. - HoldInFiatSettlementStrategy — Funds were held as a fiat balance on the destination account with no conversion to the destination token. - … - AutoOnrampSettlementStrategy — Funds were automatically converted to the destination token on settlement. - … - `type` 'usd', required - EURPayinRailDetails - `accountHolderName` string, required - `bankAddress` string, required - `bankName` string, required - `bic` string, required - `currency` 'EUR', required - `iban` string, required - `payinRail` 'SEPA', required - `type` 'eur', required - COPPayinRailDetails - `currency` 'COP', required - `payinRail` 'PSE', required - `type` 'cop', required - COPBreBPayinRailDetails - `currency` 'COP', required - `keyValue` string, required — Bre-B key value (alphanumeric identifier like @CB...) registered in the real-time payments network. - `payinRail` 'BRE_B', required - `type` 'cop-bre-b', required - BlockchainDepositPayinRailDetails - `depositToken` union, required - USDTTRONDepositToken - … - USDCSOLANADepositToken - … - `destinationAddress` string, required — The destination address for the deposit. - `senderAddress` string — The sender address for the deposit. If this is defined, the deposits MUST be made to from this address. - `type` 'blockchainDeposit', required - MXNPayinRailDetails - `bankCode` string, required — The bank code (first 3 digits of CLABE) - `bankName` string, required — The name of the bank - `clabe` string, required — CLABE - 18-digit account number for SPEI transfers - `currency` 'MXN', required - `payinRail` 'SPEI', required — The payment rail type for MXN deposits - `type` 'mxn', required - BRLPayinRailDetails - `bankName` string, required — The name of the bank - `currency` 'BRL', required - `payinRail` 'PIX', required — The payment rail type for BRL deposits - `pixBRcode` string, required — PIX BR code for instant payments - `type` 'brl', required - ARSPayinRailDetails - `accountNumber` string, required — Account number for transfers - `bankName` string, required — The name of the bank - `currency` 'ARS', required - `payinRail` 'CVU', required — The payment rail type for ARS deposits - `type` 'ars', required - `status` 'ACTIVATED' | 'DEACTIVATED', required — The status of the payin method. - `supportedDestinationTokens` PayinTokenDetails[], required — The destination tokens that the payin fiat can be converted to - `fees` PayinMethodFees, required - `developerFeePercentage` number — Developer fee percentage for the payin, applied to the payin fiat currency amount. A value of 2.5 should be viewed as 2.5% - `fixedTransactionFee` SimpleFiatAmount - `fiatAmount` number, required — The fiat amount. - `fiatCurrencyCode` 'USD' | 'COP' | 'ARS' | 'EUR' | 'MXN' | 'BRL' | 'CLP' | 'PEN' | 'BOB' | 'CRC' | 'ZAR', required — The fiat currency code. - `variableFeePercentage` number, required — Total variable fee percentage for the payin, applied to the payin fiat currency amount. A value of 0.1 should be viewed as 0.1% - `token` TokenWithBlockchain, required - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA', required — The blockchain of the token - `symbol` 'USDC' | 'USDT', required — The symbol of the token - `transactionMinimum` SimpleFiatAmount - `fiatAmount` number, required — The fiat amount. - `fiatCurrencyCode` 'USD' | 'COP' | 'ARS' | 'EUR' | 'MXN' | 'BRL' | 'CLP' | 'PEN' | 'BOB' | 'CRC' | 'ZAR', required — The fiat currency code. - `walletDetails` WalletDetails, required - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA', required — The underlying blockchain for the Account. Accounts can only have one blockchain. - `walletAddress` string, address, required - `createdAt` string, date-time, required - `description` string — The description of the Account - `destinationToken` TokenWithBlockchain, required - `blockchain` 'ETHEREUM' | 'POLYGON' | 'BASE' | 'CELO' | 'PLASMA', required — The blockchain of the token - `symbol` 'USDC' | 'USDT', required — The symbol of the token - `id` string, uuid, required — The unique identifier for the Account - `isApiEnabled` boolean, required — Whether or not the Account can be managed by the API. Accounts created in the platform will not be enabled unless you grant API access to the Account in the platform. - `name` string, required — The name of the Account - `status` 'INITIALIZING' | 'ACTIVE', required — The status of the Account. Will start in INITIALIZING and move to ACTIVE once the Account is ready to use. - `updatedAt` string, date-time, required ## Other responses - `401` — Unauthorized - `403` — SignedAgreementRequiredException --- [API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/revisions/437d277f5948/schema)