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

Verify a counterpart bank account

POST
/counterparts/:counterpart_id/bank_accounts/:bank_account_id/verify
POST
/v1/counterparts/:counterpart_id/bank_accounts/:bank_account_id/verify
$curl -X POST https://api.sandbox.monite.com/v1/counterparts/counterpart_id/bank_accounts/bank_account_id/verify \
>     -H "x-monite-version: 2024-01-31" \
>     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>     -H "Authorization: Bearer <token>"
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 contacts

Next
Built with

Authentication

AuthorizationBearer

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

Path parameters

bank_account_idstringRequired
counterpart_idstringRequired

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

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 ID Verify Request Unauthorized Error
403
Post Counterparts ID Bank Accounts ID Verify Request Forbidden Error
404
Post Counterparts ID Bank Accounts ID Verify Request Not Found Error
409
Post Counterparts ID Bank Accounts ID Verify Request Conflict Error
422
Post Counterparts ID Bank Accounts ID Verify Request Unprocessable Entity Error
500
Post Counterparts ID Bank Accounts ID Verify Request Internal Server Error