Disable bank accountBeta

POST

/v2/bank-accounts/{bank_account_id}/disable

Disable a bank account.

Guide

Disable a bank account by Id

Try in API Explorer

Link to section

Path parameters

Example code

Link to section

bank_account_id

string

Required

The ID of the bank account to disable.

Link to section

Response fields

Link to section

bank_account

The disabled 'BankAccount'

Link to section

errors

Information on errors encountered during the request.

Link to section

Examples

All versions ->

POST /v2/bank-accounts/{bank_account_id}/disable

curl https://connect.squareup.com/v2/bank-accounts/bact%3AOxfBTiXgByaXds1K4GB/disable \
  -X POST \
  -H 'Square-Version: 2026-01-22' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "bank_account": {
    "id": "bact:OxfBTiXgByaXds1K4GB",
    "account_number_suffix": "000",
    "country": "US",
    "currency": "USD",
    "account_type": "CHECKING",
    "holder_name": "Nicola Snow",
    "primary_bank_identification_number": "011401533",
    "status": "DISABLED",
    "creditable": true,
    "debitable": true,
    "fingerprint": "sq-1-mO3XNctJpTLL8uYowOWpioS8nQyTc838gcBo90254XonoEJ_c7Uw6yqL6qihFNY8fA",
    "version": 3,
    "bank_name": "Citizens Bank",
    "customer_id": "HM3B2D5JKGZ69359BTEHXM2V8M"
  }
}