Validate IBAN or BIC
validate_identifierValidate an IBAN or BIC identifier in one call. Returns pass/fail and an error explanation when invalid.
Instructions
Validate a single financial identifier (IBAN or BIC).
Use this for a one-off identifier check with a clear pass/fail and
reason. To validate identifiers embedded across a whole batch, prefer
``validate_records`` / ``validate_payment_scheme`` instead of calling
this per field.
Returns ``{"kind": str, "value": str, "valid": bool, "error": str}``
(the ``error`` key is present only when ``valid`` is ``False``).
Args:
kind: One of ``"iban"`` or ``"bic"`` (case-insensitive).
value: The identifier value to check.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Which identifier to validate: 'iban' or 'bic' (case-insensitive). Any other value returns an error. | |
| value | Yes | The identifier string to check — an IBAN or BIC/SWIFT code matching the chosen kind. |