BizKitHub
DocsInteractive API Docs/api/v1/bank/bank-account-status
get

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

Endpoint Info
Base URLapi.bizkithub.com
AuthBearer Token
Methods1
Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

2 query parameters

apiKeystringrequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

bankAccountstringrequired

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 Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/bank/bank-account-status?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&bankAccount=CZ5420100000002002770630", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);
get

Example Response

200Success
{
  "success": true,
  "iban": "CZ5420100000002002770630",
  "domestic": "2002770630/2010"
}

cURL

Command line example

curl -X GET "https://api.bizkithub.com/api/v1/bank/bank-account-status?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&bankAccount=CZ5420100000002002770630" \
  -H "Content-Type: application/json"

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key
Back to API DocumentationAPI Reference