BizKitHubDocs

/api/v1/bank/bank-account-status

Validate / normalize a bank account and return its canonical IBAN.

The endpoint accepts either an IBAN or a Czech domestic account format and tries to convert it to a valid IBAN.

Input

  • bankAccount: IBAN or CZ domestic account.
  • apiKey: standard API key.

Behavior

  • If bankAccount is a valid IBAN → returns it normalized (uppercased, without separators).
  • If it looks like a Czech IBAN with wrong check digits → recomputes and repairs the checksum.
  • If it is a Czech domestic account → converts it to CZ IBAN.
  • If conversion/validation fails → returns { success: false }.

Output

  • iban: canonical IBAN (no spaces).
  • domestic: formatted domestic account representation (Czech format).

Notes

This endpoint does not verify whether the account actually exists at a bank; it only validates and normalizes the format.

get
Tags:bank
Operation ID: getApiV1BankBank-account-status
Query Parameters
apiKeystring
required

Your BizKitHub API key (passed as GET parameter)

Get API Key →
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 }.

Responses
200

No description

Base URL:
https://bizkithub.com

Example Request

fetch('https://bizkithub.com/api/v1/bank/bank-account-status?apiKey=YOUR_API_KEY', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
})

Example Response

HTTP 200Success Response
{
  "success": true,
  "data": {
    "message": "Example response"
  }
}

🔑 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