Update a counterpart's bank account

Authentication

AuthorizationBearer

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

Path parameters

bank_account_idstringRequired

counterpart_idstringRequired

Request

This endpoint expects an object.

account_holder_namestringOptional

The name of the person or business that owns this bank account. Required for US bank accounts to accept ACH payments.

account_numberstringOptional

The bank account number. Required for US bank accounts to accept ACH payments. US account numbers contain 9 to 12 digits. UK account numbers typically contain 8 digits.

bicstringOptional<=11 characters

The BIC/SWIFT code of the bank.

countryenumOptional

currencyenumOptional

ibanstringOptional<=34 characters

The IBAN of the bank account.

namestringOptional<=200 characters

partner_metadatamap from strings to anyOptional

Metadata for partner needs.

routing_numberstringOptional

The bank’s routing transit number (RTN). Required for US bank accounts to accept ACH payments. US routing numbers consist of 9 digits.

sort_codestringOptional

The bank's sort code.

Response

Successful Response

idstringformat: "uuid"

counterpart_idstringformat: "uuid"

countryenum

currencyenum

open_banking_verification_statusenum

Open banking verification status

account_holder_namestring

The name of the person or business that owns this bank account. Required for US bank accounts to accept ACH payments.

account_numberstring

The bank account number. Required for US bank accounts to accept ACH payments. US account numbers contain 9 to 12 digits. UK account numbers typically contain 8 digits.

bicstring<=11 characters

The BIC/SWIFT code of the bank.

ibanstring<=34 characters

The IBAN of the bank account.

is_default_for_currencybooleanDefaults to false

namestring<=200 characters

open_banking_verification_errorstring

Last verification error message

partner_metadatamap from strings to any

Metadata for partner needs.

routing_numberstring

The bank’s routing transit number (RTN). Required for US bank accounts to accept ACH payments. US routing numbers consist of 9 digits.

sort_codestring

The bank's sort code.

Errors

401

Patch Counterparts ID Bank Accounts ID Request Unauthorized Error

403

Patch Counterparts ID Bank Accounts ID Request Forbidden Error

404

Patch Counterparts ID Bank Accounts ID Request Not Found Error

422

Patch Counterparts ID Bank Accounts ID Request Unprocessable Entity Error

429

Patch Counterparts ID Bank Accounts ID Request Too Many Requests Error

1	using RestSharp;
2
3	var client = new RestClient("https://api.sandbox.monite.com/v1/counterparts/counterpart_id/bank_accounts/bank_account_id");
4	var request = new RestRequest(Method.PATCH);
5	request.AddHeader("x-monite-version", "2024-05-25");
6	request.AddHeader("x-monite-entity-id", "9d2b4c8f-2087-4738-ba91-7359683c49a4");
7	request.AddHeader("Authorization", "Bearer <token>");
8	request.AddHeader("Content-Type", "application/json");
9	request.AddParameter("application/json", "{}", ParameterType.RequestBody);
10	IRestResponse response = client.Execute(request);

1	{
2	"id": "id",
3	"counterpart_id": "counterpart_id",
4	"country": "AF",
5	"currency": "AED",
6	"open_banking_verification_status": "not_verified",
7	"account_holder_name": "Bob Jones",
8	"account_number": "12345678",
9	"bic": "DEUTDEFFXXX",
10	"iban": "DE74500700100100000900",
11	"is_default_for_currency": true,
12	"name": "name",
13	"open_banking_verification_error": "open_banking_verification_error",
14	"partner_metadata": {
15	"key": "value"
16	},
17	"routing_number": "routing_number",
18	"sort_code": "123456"
19	}

Authentication

Path parameters

Headers

Request

Response

Errors