Create an entity bank account
Adds a new bank account for the specified entity.
The minimum required fields are currency
and country
. Other required fields depend on the currency and country.
Bank accounts in African countries can use any fields or combinations of fields.
For other countries:
- EUR accounts require
iban
. - GBP accounts require
account_holder_name
,account_number
, andsort_code
. - USD accounts require
account_holder_name
,account_number
, androuting_number
. - Accounts in other currencies require one of:
iban
account_number
andsort_code
account_number
androuting_number
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
The ID of the entity that owns the requested resource.
Request
The country in which the bank account is registered, repsesented as a two-letter country code (ISO 3166-1 alpha-2).
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.
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.
The bank name.
The SWIFT/BIC code of the bank. Can be either 8 or 11 characters long. Monite verifies the BIC length, country code, and whether the structure conforms to ISO 9362.
If bic
is specified, iban
must also be specified.
User-defined name of this bank account, such as ‘Primary account’ or ‘Savings account’.
The IBAN of the bank account, up to 34 characters. Required if the account currency is EUR. Monite verifies the IBAN length, checksum digits, and country-specific format according to ISO 13616.
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.
The bank’s routing transit number (RTN) or branch code. Required if the account currency is USD. US routing numbers consist of 9 digits.
The bank’s sort code. Required if the account currency is GBP.
Response
Successful Response
Unique ID of the bank account.
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.
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.
The bank name.
The SWIFT/BIC code of the bank. Can be either 8 or 11 characters long. Monite verifies the BIC length, country code, and whether the structure conforms to ISO 9362.
If bic
is specified, iban
must also be specified.
The country in which the bank account is registered, repsesented as a two-letter country code (ISO 3166-1 alpha-2).
User-defined name of this bank account, such as ‘Primary account’ or ‘Savings account’.
The IBAN of the bank account, up to 34 characters. Required if the account currency is EUR. Monite verifies the IBAN length, checksum digits, and country-specific format according to ISO 13616.
Indicates whether this bank account is the default one for its currency.
The bank’s routing transit number (RTN) or branch code. Required if the account currency is USD. US routing numbers consist of 9 digits.
The bank’s sort code. Required if the account currency is GBP.
ID of the entity user who added this bank account, or null
if it was added using a partner access token.