Skip to main content
Get a Bank Account
curl --request GET \
  --url https://api.spherepay.co/v2/bank-account/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
  "status": "active",
  "bankName": "Chase",
  "accountName": "Jane Doe Checking",
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "created": "2025-01-01T00:00:00Z",
  "updated": "2025-01-01T00:00:00Z",
  "currency": "usd",
  "accountDetails": {
    "accountNumber": "****7890",
    "routingNumber": "021000021",
    "accountType": "checking"
  },
  "accountOwner": {
    "accountHolderName": "Jane Doe",
    "relationship": "self"
  },
  "networks": [
    "ach",
    "wire"
  ]
}
Use this endpoint to retrieve a single bank account by its ID. The response includes masked account details (such as a partially redacted account number), the payment networks registered for the account, and the ID of the owning customer.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The bank account ID

Minimum string length: 1
Example:

"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045"

Response

​
id
string
required

The unique identifier of the bank account.

Example:

"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045"

​
status
enum<string>
required

The current status of the bank account.

Available options:
pending,
active,
inactive,
invalid
Example:

"active"

​
bankName
string
required

The name of the financial institution where the account is held.

Example:

"Bank of America"

​
accountName
string
required

A descriptive name for this bank account.

Example:

"Checking Account"

​
customerId
string
required

The unique identifier of the customer who owns this bank account.

Example:

"customer_66c4168d418a410eae282b83883bdc39"

​
created
string
required

The ISO 8601 timestamp when the bank account was created.

Example:

"2025-01-01T00:00:00Z"

​
updated
string
required

The ISO 8601 timestamp when the bank account was last updated.

Example:

"2025-01-01T00:00:00Z"

​
currency
enum<string>
required

The currency of the bank account.

Available options:
usd
Example:

"usd"

​
accountDetails
object
required

USD account details including accountNumber, routingNumber, and accountType.

​
accountOwner
object
required

Information about the account owner, including their name and relationship to the customer.

​
networks
enum<string>[]
required

The payment networks supported by this bank account. For USD accounts, includes at least one of "ach" or "wire".

Available options:
ach,
wire
Example:
["wire", "ach"]
Last modified on June 18, 2026