Virtual account
Get a Virtual Account
AuthorizationBearer <token>
JWT Bearer token authentication
In: header
Path Parameters
virtual_account_idstring
The virtual account's unique ID generated by SpherePay upon virtual account creation.
Match
^virtualAccount_[a-z0-9]+$
Response Body
curl -X GET "https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4"
{
"id": "virtualAccount_987xyz654",
"active": true,
"fees": {
"totalBpsRate": "20",
"integratorFee": {
"bpsRate": "10"
},
"platformFee": {
"bpsRate": "10"
}
},
"depositInstructions": {
"currency": "USD",
"bankName": "Bank of Example",
"bankAccountNumber": "000123456789",
"bankRoutingNumber": "1234567890",
"bankBeneficiaryName": "John Doe",
"bankBeneficiaryAddress": "123 Main St, Anytown, USA"
},
"destination": {
"currency": "USDC",
"walletAddress": "0x1234...abcd",
"network": "ethereum"
},
"created": "2025-04-20T21:49:46.697Z",
"updated": "2025-04-20T21:50:18.854Z"
}
{
"ts": "2025-04-20T00:09:16.870Z",
"error": {
"general": "{{information}} Not Found"
}
}