MOmonta
Team bank accounts

Update a team's bank account

Changed on

Required scope: team-bank-accounts:write </br>Organization authorization: supported</br></br>An omitted field keeps its stored value. The account must still satisfy the fields its type requires once the update is applied.

patch/api/v1/teams/{teamId}/bank-accounts/{bankAccountId}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/teams/{teamId}/bank-accounts/{bankAccountId}
  • Auth
    HTTP bearer

Path parameters

teamIdinteger required
bankAccountIdinteger required

Request body

namestring nullable

Name of the bank account

type'iban' | 'swift' | 'bsb' | 'sort_account' | 'routing_account' | 'local_canadian' | 'emirates' required

Which set of fields identifies the account.</br></br>iban requires iban. swift requires swift. bsb requires bsb. sort_account requires sortCode and accountNumber. routing_account requires routingNumber, accountNumber and accountType. local_canadian requires institutionNumber, transitNumber and accountNumber. emirates requires iban.

ibanstring nullable

IBAN of the bank account. Validated against its check digits.

swiftstring nullable

SWIFT/BIC of the bank account

bsbstring nullable

BSB number of the bank account (Australia)

sortCodestring nullable

Sort code of the bank account (United Kingdom)

accountNumberstring nullable

Account number of the bank account

routingNumberstring nullable

Routing number of the bank account (United States)

accountType'checking' | 'savings' nullable

Account type, required with receive option routing_account

transitNumberstring nullable

Transit number of the bank account (Canada, 5 digits)

institutionNumberstring nullable

Institution number of the bank account (Canada, 3 digits)

Example request

{
  "name": "Primary account",
  "type": "iban",
  "iban": "DK5000400440116243",
  "swift": "IIIGGB22",
  "bsb": "805050",
  "sortCode": "12-34-56",
  "accountNumber": "654318465131864",
  "routingNumber": "123456789",
  "accountType": "checking",
  "transitNumber": "12345",
  "institutionNumber": "001"
}

Response

Bank account updated

idinteger

Id of the bank account

namestring required

Name of the bank account

type'iban' | 'swift' | 'bsb' | 'sort_account' | 'routing_account' | 'local_canadian' | 'emirates' nullable

Which set of fields identifies the account. Determines what the other fields must contain.

ibanstring nullable

IBAN of the bank account

swiftstring nullable

SWIFT/BIC of the bank account

bsbstring nullable

BSB number of the bank account (Australia)

sortCodestring nullable

Sort code of the bank account (United Kingdom)

accountNumberstring nullable

Account number of the bank account

routingNumberstring nullable

Routing number of the bank account (United States)

accountType'checking' | 'savings' nullable

Account type, required with receive option routing_account

transitNumberstring nullable

Transit number of the bank account

institutionNumberstring nullable

Institution number of the bank account

currencyIdinteger

Id of the bank account's currency

createdAtstring date-time required

When the bank account was created

updatedAtstring date-time nullable

When the bank account was last updated

Example response

{
  "id": 1,
  "name": "Primary account",
  "type": "iban",
  "iban": "DK5000400440116243",
  "swift": "IIIGGB22",
  "bsb": "805050",
  "sortCode": "12-34-56",
  "accountNumber": "654318465131864",
  "routingNumber": "123456789",
  "accountType": "checking",
  "transitNumber": "12345",
  "institutionNumber": "001",
  "currencyId": 1,
  "createdAt": "2022-05-12T15:56:45Z",
  "updatedAt": "2022-05-12T15:56:45Z"
}

Changes