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

List Transfers of a Virtual Account

GET
/v2/virtual-account/{virtual_account_id}/transfer
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/transfer"
fetch("https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4/transfer")
package main

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

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

  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/transfer"

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

print(response.text)
{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "transfer": [
      {
        "id": "payout_727a8a9a7e4a46a7839eb5a55424934c",
        "number": 4,
        "type": "onRamp",
        "status": "pending",
        "meta": {},
        "lookupKey": null,
        "amount": "100.00",
        "finalAmount": "99.00",
        "fee": "1.00",
        "source": {
          "id": "bankAccount_fdef235388c240eb8b14dad8ed542e53",
          "currency": "usd",
          "network": "achPush"
        },
        "funding": {
          "id": "bankAccount_15e94e2bfd614a0483afe09f96dae90a",
          "currency": "usd",
          "network": "achPush"
        },
        "destination": {
          "id": "wallet_5655089bfb164769b085f6fd9f1e25a0",
          "currency": "usdc",
          "network": "ethereum"
        },
        "instructions": {
          "memo": "BRGUEWY5SEWHESVTMW94",
          "imad": null,
          "omad": null,
          "human": "Send 100 usd via the achPush network from bankAccount_fdef235388c240eb8b14dad8ed542e53 with an account number of ********9389 to bankAccount_15e94e2bfd614a0483afe09f96dae90a with an account number of ********1267. After sending usd, the payout will be funded and 100 of usdc will be on-ramped to wallet_5655089bfb164769b085f6fd9f1e25a0 with an address of 0x7Aa40147383F5c985Bd6D90D8d6832cF9091fcF1 on the ethereum network.",
          "machine": "",
          "resource": {
            "id": "bankAccount_15e94e2bfd614a0483afe09f96dae90a",
            "status": "active",
            "bankName": "Lead Bank",
            "accountHolderName": "Sphere",
            "accountName": "Sphere",
            "accountNumber": "213796231267",
            "customer": null,
            "last4": "1267",
            "routingNumber": "101019644",
            "bic": null,
            "iban": null,
            "bankAddressString": "1801 Main St. Kansas City MO 64108, Kansas, United States of America",
            "meta": {},
            "lookupKey": null,
            "currency": "usd",
            "walletBankAccounts": [],
            "accountType": "checking",
            "updated": "2025-01-16T21:05:22.192Z",
            "created": "2025-01-16T21:05:22.192Z",
            "deleted": null
          }
        },
        "failureReason": null,
        "failureReasonExplanation": null,
        "mock": false,
        "customer": "customer_68f1c089703945e7bbff6f04bf1c5041",
        "updated": "2025-04-19T21:50:00.623Z",
        "created": "2025-04-19T21:46:09.554Z"
      }
    ],
    "ts": "2025-04-19T22:53:56.782Z",
    "request": "request_da9225517eee4f73bd34ec6c84e28414"
  }
}
{
  "ts": "2025-04-20T00:09:16.870Z",
  "error": {
    "general": "{{information}} Not Found"
  }
}