Bank accounts

Update Bank Account

Omitted or blank bank_code and bank_name are derived from the IBAN using the same offline bank registry as the info-by-iban lookup. No error is raised when the BIC can't be resolved.
PUT/v1/customers/{customer_uuid}/bank-accounts/{account_uuid}/

Authorization

X-Api-Key
string required
API key generated in the Developers section of the Stablegate app. Send it in the X-Api-Key header on every request; the partner API does not require request signing.

Path parameters

account_uuid
string<uuid> required
Bank account UUID
customer_uuid
string<uuid> required
Customer UUID

Request body

name
string | null
iban
string | null
IBAN for SEPA; spaces allowed. For other rails use account_number.
account_number
string | null
Account number for ACH, FedWire or SWIFT.
supported_rails
string[] | null
Supported transfer types. Omitted or null means SEPA. FedWire is encoded as wire.
bank_routing_number
string | null
9-digit ABA routing number for US payments.
bank_code
string | null
SWIFT/BIC. For SEPA derived from the IBAN when omitted or blank; not used for ACH/FedWire.
bank_name
string | null
Bank name. For SEPA derived from the IBAN when omitted or blank.
bank_country
string | null
bank_address
string | null
bank_city
string | null
bank_postal_code
string | null
bank_region
string | null
holder_name
string required
holder_country
string | null
holder_city
string | null
holder_street
string | null
holder_postal_code
string | null
holder_region
string | null

Responses

Successful Response

uuid
string<uuid> required
name
string | null
iban
string | null
account_number
string | null
supported_rails
string[] | null
bank_routing_number
string | null
bank_city
string | null
bank_postal_code
string | null
bank_region
string | null
holder_country
string | null
holder_city
string | null
holder_street
string | null
holder_postal_code
string | null
holder_region
string | null
bank_name
string | null
bank_code
string | null
bank_country
string | null
bank_address
string | null
holder_name
string | null
created_at
string<date-time> required
updated_at
string<date-time> required
curl https://api.stablegate.com/v1/customers/CUSTOMER_UUID/bank-accounts/ACCOUNT_UUID/ \
  --request PUT \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "string",
  "iban": "string",
  "account_number": "string",
  "supported_rails": [
    "sepa"
  ],
  "bank_routing_number": "string",
  "bank_code": "string",
  "bank_name": "string",
  "bank_country": "string",
  "bank_address": "string",
  "bank_city": "string",
  "bank_postal_code": "string",
  "bank_region": "string",
  "holder_name": "string",
  "holder_country": "string",
  "holder_city": "string",
  "holder_street": "string",
  "holder_postal_code": "string",
  "holder_region": "string"
}'
{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "iban": "string",
  "account_number": "string",
  "supported_rails": [
    "sepa"
  ],
  "bank_routing_number": "string",
  "bank_city": "string",
  "bank_postal_code": "string",
  "bank_region": "string",
  "holder_country": "string",
  "holder_city": "string",
  "holder_street": "string",
  "holder_postal_code": "string",
  "holder_region": "string",
  "bank_name": "string",
  "bank_code": "string",
  "bank_country": "string",
  "bank_address": "string",
  "holder_name": "string",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}
Copyright © 2026