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

bankgetApiV1BankBank-account-status

Parameters

2 query

2 total

Query · 2

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

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

Request

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

get

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

Response

JSON payload

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

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key