Starknet: USDC On/OffRamp live.   Details →
Sphere Paysphere
Virtual account

Get a Virtual Account

GET
/v2/virtual-account/{virtual_account_id}

Authorization

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.

Pattern"^virtualAccount_[a-z0-9]+$"

Response Body

curl -X GET "https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4"
fetch("https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4"

response = requests.request("GET", url)

print(response.text)
{
  "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"
  }
}