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

Get a Bank Account by ID

GET
/v2/customers/{customer_id}/bank-account/{bank_account_id}
AuthorizationBearer <token>

JWT Bearer token authentication

In: header

Path Parameters

customer_idstring

The customer's unique ID generated by SpherePay upon customer creation.

Match^customer_[a-z0-9]+$
bank_account_idstring

The bank account's unique ID generated by SpherePay upon bank account creation.

Match^bankAccount_[a-z0-9]+$

Response Body

curl -X GET "https://api.sandbox.spherepay.co/v2/customers/customer_1ab2c3d4/bank-account/bankAccount_1ab2c3d4"

{
  "id": "bankAccount_1c19dcf3caaa447bb209df0e5d599e8d",
  "status": "active",
  "bankName": "Chase",
  "accountHolderName": "John Mock-Doe",
  "accountName": "Savings Account",
  "customer": "customer_68f1c089703945e7bbff6f04bf1c5041",
  "currency": "usd",
  "accountDetails": {
    "accountNumber": "**********6789",
    "routingNumber": "**********6789",
    "accountType": "checking | savings"
  }
}

{
  "ts": "2025-04-20T02:32:52.669Z",
  "error": {
    "general": "Bank account not found"
  }
}