Add a new bank account for the specified entity.
The minimum required fields are `currency` and `country`. Other required fields depend on the currency:
* EUR accounts require `iban`.
* GBP accounts require `account_holder_name`, `account_number`, and `sort_code`.
* USD accounts require `account_holder_name`, `account_number`, and `routing_number`.
* Accounts in other currencies require one of:
* `iban`
* `account_number` and `sort_code`
* `account_number` and `routing_number`
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.
Request
This endpoint expects an object.
countryenumRequired
The country in which the bank account is registered, repsesented as a two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
currencyenumRequired
The currency of the bank account, represented as a three-letter ISO [currency code](https://docs.monite.com/references/currencies).
account_holder_namestringOptional
The name of the person or business that owns this bank account. Required in the following cases:
* the account currency is GBP or USD,
* the account currency is EUR and the entity wishes to receive SEPA Credit transfers to this account.
account_numberstringOptional
The bank account number. Required if the account currency is GBP or USD. UK account numbers typically contain 8 digits. US bank account numbers contain 9 to 12 digits.
bank_namestringOptional
The bank name.
bicstringOptional<=11 characters
The SWIFT/BIC code of the bank.
display_namestringOptional
User-defined name of this bank account, such as ‘Primary account’ or ‘Savings account’.
ibanstringOptional<=34 characters
The IBAN of the bank account. Required if the account currency is EUR.
is_default_for_currencybooleanOptionalDefaults to false
If set to true or if this is the first bank account added for the given currency, this account becomes the default one for its currency.
routing_numberstringOptional
The bank’s routing transit number (RTN). Required if the account currency is USD. US routing numbers consist of 9 digits.
sort_codestringOptional
The bank's sort code. Required if the account currency is GBP.
Response
Successful Response
idstringformat: "uuid"
Unique ID of the bank account.
open_banking_verification_statusenum
Open banking verification status
account_holder_namestring
The name of the person or business that owns this bank account. Required in the following cases:
the account currency is GBP or USD,
the account currency is EUR and the entity wishes to receive SEPA Credit transfers to this account.
account_numberstring
The bank account number. Required if the account currency is GBP or USD. UK account numbers typically contain 8 digits. US bank account numbers contain 9 to 12 digits.
account_number_last4string
The last 4 digits of the bank account number.
bank_namestring
The bank name.
bicstring
The SWIFT/BIC code of the bank.
countryenum
The country in which the bank account is registered, repsesented as a two-letter country code (ISO 3166-1 alpha-2).
currencyenum
The currency of the bank account, represented as a three-letter ISO currency code.
display_namestring
User-defined name of this bank account, such as ‘Primary account’ or ‘Savings account’.
ibanstring
The IBAN of the bank account. Required if the account currency is EUR.
is_default_for_currencybooleanDefaults to false
Indicates whether this bank account is the default one for its currency.
open_banking_verification_errorstring
Last verification error message
routing_numberstring
The bank’s routing transit number (RTN). Required if the account currency is USD. US routing numbers consist of 9 digits.
sort_codestring
The bank's sort code. Required if the account currency is GBP.
was_created_by_user_idstringformat: "uuid"
ID of the entity user who added this bank account, or null if it was added using a partner access token.
Errors
409
Post Bank Accounts Request Conflict Error
422
Post Bank Accounts Request Unprocessable Entity Error
