/api/v1/customer/add-bank-account

API endpoint documentation

post

Tags:customer

Operation ID: postApiV1CustomerAdd-bank-account

Query Parameters

apiKeystring

required

Your BizKitHub API key (passed as GET parameter)

Get API Key →

Body

cuRefNostring

required

cuRefNo = customer reference number.

Example: "1cGIHvFoQDGLAbcA"

bankAccountstring

required

Bank account identifier to be validated / converted to IBAN.

Supported formats:

IBAN (ISO 7064 MOD-97-10), e.g. CZ5420100000002002770630.
- Spaces and separators are allowed; they will be removed.
- Letters are uppercased automatically.
- For CZ IBANs with incorrect check digits, the checksum may be repaired (recomputed from BBAN).
Czech domestic format (national account), e.g. 2002770630/2010.
- Optional prefix is supported: 000000-2002770630/2010.
- The bank code must be 4 digits.
- Prefix max 6 digits, account number max 10 digits.
Digits-only technical formats (Czech accounts only):
- 20 digits BBAN: BBBBPPPPPPAAAAAAAAAA (bank 4 + prefix 6 + account 10).
- 22 digits: CCBBBB... where it represents CZ + check digits + BBAN without the country prefix.
- Without separators: <account+optional prefix><bank>, e.g. 20027706302010.

Invalid input: If the value contains letters but is not a valid/repairable IBAN, conversion fails and the endpoint returns { success: false }.

Example: "CZ5420100000002002770630"

Responses

200

No description

Base URL:

https://bizkithub.com

Example Request

fetch('https://bizkithub.com/api/v1/customer/add-bank-account?apiKey=YOUR_API_KEY', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
        "cuRefNo": "1cGIHvFoQDGLAbcA",
        "bankAccount": "CZ5420100000002002770630"
    })
})

Example Response

HTTP 200Success Response

{
  "success": false
}

🔑 API Key Required

All BizKitHub API endpoints require authentication using an API key. The API key must be passed as a GET parameter in the URL for all requests.

Get API Key →API Overview →

Back to API Documentation

Last updated: January 2, 2026