Team bank accounts

List a team's bank accounts

GET

https://partner-api.monta.com

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

Required scope: team-bank-accounts:read
Organization authorization: supported

List a team's bank accounts › path Parameters

teamId

integer · int64 · required

List a team's bank accounts › Responses

The team's bank accounts

BankAccount[]

BankAccount

name

string · required

Name of the bank account

Example: Primary account

createdAt

string · date-time · required

When the bank account was created

Example: 2022-05-12T15:56:45Z

id

integer · int64

Id of the bank account

Example: 1

type

string | null · enum

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

Enum values:

iban

swift

bsb

sort_account

routing_account

local_canadian

emirates

Example: iban

iban

string | null

IBAN of the bank account

Example: DK5000400440116243

swift

string | null

SWIFT/BIC of the bank account

Example: IIIGGB22

bsb

string | null

BSB number of the bank account (Australia)

Example: 805050

sortCode

string | null

Sort code of the bank account (United Kingdom)

Example: 12-34-56

accountNumber

string | null

Account number of the bank account

Example: 654318465131864

routingNumber

string | null

Routing number of the bank account (United States)

Example: 123456789

accountType

string | null · enum

Account type, required with receive option routing_account

Enum values:

checking

savings

Example: checking

transitNumber

string | null

Transit number of the bank account

Example: 12345

institutionNumber

string | null

Institution number of the bank account

Example: 001

currencyId

integer · int64

Id of the bank account's currency

Example: 1

updatedAt

string | null · date-time

When the bank account was last updated

Example: 2022-05-12T15:56:45Z

Add a bank account to a team

POST

https://partner-api.monta.com

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

Required scope: team-bank-accounts:write
Organization authorization: supported

The required fields depend on type value provided with the request

Add a bank account to a team › path Parameters

teamId

integer · int64 · required

Add a bank account to a team › Request Body

CreateBankAccount

name

string · minLength: 1 · required

Name of the bank account

Example: Primary account

type

string · enum · minLength: 1 · required

Which set of fields identifies the bank account.

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.

Enum values:

iban

swift

bsb

sort_account

routing_account

local_canadian

emirates

Example: iban

iban

string | null

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

Example: DK5000400440116243

swift

string | null

SWIFT/BIC of the bank account

Example: IIIGGB22

bsb

string | null

BSB number of the bank account (Australia)

Example: 805050

sortCode

string | null

Sort code of the bank account (United Kingdom)

Example: 12-34-56

accountNumber

string | null

Account number of the bank account

Example: 654318465131864

routingNumber

string | null

Routing number of the bank account (United States)

Example: 123456789

accountType

string | null · enum

Account type, required with receive option routing_account

Enum values:

checking

savings

Example: checking

transitNumber

string | null

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

Example: 12345

institutionNumber

string | null

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

Example: 001

Add a bank account to a team › Responses

Bank account created

No data returned

POST/api/v1/teams/{teamId}/bank-accounts

curl https://partner-api.monta.com/api/v1/teams/:teamId/bank-accounts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "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"
}'

Example Request Body

{
  "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"
}

json

Example Responses

No example specified for this content type

Update a team's bank account

PATCH

https://partner-api.monta.com

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

Required scope: team-bank-accounts:write
Organization authorization: supported

An omitted field keeps its stored value. The account must still satisfy the fields its type requires once the update is applied.

Update a team's bank account › path Parameters

teamId

integer · int64 · required

bankAccountId

integer · int64 · required

Update a team's bank account › Request Body

UpdateBankAccount

type

string · enum · minLength: 1 · required

Which set of fields identifies the account.

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.

Enum values:

iban

swift

bsb

sort_account

routing_account

local_canadian

emirates

Example: iban

name

string | null

Name of the bank account

Example: Primary account

iban

string | null

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

Example: DK5000400440116243

swift

string | null

SWIFT/BIC of the bank account

Example: IIIGGB22

bsb

string | null

BSB number of the bank account (Australia)

Example: 805050

sortCode

string | null

Sort code of the bank account (United Kingdom)

Example: 12-34-56

accountNumber

string | null

Account number of the bank account

Example: 654318465131864

routingNumber

string | null

Routing number of the bank account (United States)

Example: 123456789

accountType

string | null · enum

Account type, required with receive option routing_account

Enum values:

checking

savings

Example: checking

transitNumber

string | null

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

Example: 12345

institutionNumber

string | null

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

Example: 001

Update a team's bank account › Responses

Bank account updated

BankAccount

name

string · required

Name of the bank account

Example: Primary account

createdAt

string · date-time · required

When the bank account was created

Example: 2022-05-12T15:56:45Z

id

integer · int64

Id of the bank account

Example: 1

type

string | null · enum

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

Enum values:

iban

swift

bsb

sort_account

routing_account

local_canadian

emirates

Example: iban

iban

string | null

IBAN of the bank account

Example: DK5000400440116243

swift

string | null

SWIFT/BIC of the bank account

Example: IIIGGB22

bsb

string | null

BSB number of the bank account (Australia)

Example: 805050

sortCode

string | null

Sort code of the bank account (United Kingdom)

Example: 12-34-56

accountNumber

string | null

Account number of the bank account

Example: 654318465131864

routingNumber

string | null

Routing number of the bank account (United States)

Example: 123456789

accountType

string | null · enum

Account type, required with receive option routing_account

Enum values:

checking

savings

Example: checking

transitNumber

string | null

Transit number of the bank account

Example: 12345

institutionNumber

string | null

Institution number of the bank account

Example: 001

currencyId

integer · int64

Id of the bank account's currency

Example: 1

updatedAt

string | null · date-time

When the bank account was last updated

Example: 2022-05-12T15:56:45Z

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

curl https://partner-api.monta.com/api/v1/teams/:teamId/bank-accounts/:bankAccountId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "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"
}'

Example Request Body

{
  "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"
}

json

Example Responses

{
  "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"
}

json

application/json

Team Members Teams