For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
API StatusPartner Portal
HomeGuidesAPI ExplorerSDKsGitHubSupport
HomeGuidesAPI ExplorerSDKsGitHubSupport
  • API Concepts
    • Overview
    • Environments and URLs
    • Authentication
    • API versioning
    • Rate limiting
    • HTTP headers
    • Pagination, sorting, and filtering
  • General
  • Common
      • GETGet a counterpart's bank accounts
      • POSTCreate a counterpart bank account
      • GETGet a counterpart's bank account
      • DELDelete a counterpart's bank account
      • PATCHUpdate a counterpart's bank account
      • POSTSet a counterpart's bank account as default for its currency
      • POSTVerify a counterpart bank account
  • Accounts payable
  • Accounts receivable
  • E-invoicing
  • Payments
  • Accounting integration
  • Expense management
  • Utilities
LogoLogo
API StatusPartner Portal
CommonCounterpart bank accounts

Create a counterpart bank account

POST
/counterparts/:counterpart_id/bank_accounts
POST
/v1/counterparts/:counterpart_id/bank_accounts
$curl -X POST https://api.sandbox.monite.com/v1/counterparts/counterpart_id/bank_accounts \
>     -H "x-monite-version: 2024-01-31" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "country": "AF",
>  "currency": "AED"
>}'
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}
Was this page helpful?
Previous

Get a counterpart's bank account

Next
Built with

Authentication

AuthorizationBearer

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

Path parameters

counterpart_idstringRequired

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
currencyenumRequired
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.

ibanstringOptional<=34 characters
The IBAN of the bank account.
is_default_for_currencybooleanOptionalDefaults to false
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
Post Counterparts ID Bank Accounts Request Unauthorized Error
403
Post Counterparts ID Bank Accounts Request Forbidden Error
404
Post Counterparts ID Bank Accounts Request Not Found Error
422
Post Counterparts ID Bank Accounts Request Unprocessable Entity Error
500
Post Counterparts ID Bank Accounts Request Internal Server Error