Skip to main content
Update Bank Account
curl --request PATCH \
  --url https://api.spherepay.co/v2/bank-account/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "networks": [
    "ach",
    "wire"
  ]
}
'
{
  "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
  "status": "active",
  "bankName": "Chase",
  "accountName": "Jane Doe Checking",
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "created": "2025-01-01T00:00:00Z",
  "updated": "2025-01-02T09:15:00Z",
  "currency": "usd",
  "accountDetails": {
    "accountNumber": "****7890",
    "routingNumber": "021000021",
    "accountType": "checking"
  },
  "accountOwner": {
    "accountHolderName": "Jane Doe",
    "relationship": "self"
  },
  "networks": [
    "ach",
    "wire"
  ]
}
Use this endpoint to update a registered bank account. Currently, the only mutable field is networks, which controls which payment rails are enabled for the account. The new networks value must be compatible with the account’s currency — you cannot add an incompatible network after creation.

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"

Body

application/json
​
networks
enum<string>[]
required

The payment networks supported by this bank account. Must match the bank account currency: USD accounts support ["ach", "wire"], EUR accounts support ["sepa"], BRL accounts support ["pix"].

Minimum array length: 1
Available options:
ach,
wire,
sepa,
pix
Example:
["wire", "ach"]

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