BizKitHub
DocsAPI ReferenceBank/api/v1/bank/bank-account-status
getBankPublic API v1

/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

Query parameters

· 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

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

ExampleCZ5420100000002002770630

Response schema

1 status code documented

200Success
object | object
One of 2:
Variant 1
successbooleanRequired

Operation result. When true, fields iban and domestic are present.

Exampletrue
ibanstringRequired

Canonical IBAN (uppercased, without spaces or separators).

ExampleCZ5420100000002002770630
domesticstringRequired

Domestic bank account format derived from the IBAN (Czech format).

Example2002770630/2010
Variant 2
successbooleanRequired

Operation result. When false, the provided bankAccount could not be converted to a valid IBAN.

Examplefalse

Response example

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

Request example

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"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key