apyhub
DATA VALIDATION · FINANCE

IBAN Validator

What it does

IBAN Validator checks whether an International Bank Account Number is valid and returns a normalized result you can use in your workflow.

Send an iban string in the request body. The response returns either false when the IBAN is invalid, or a structured object with valid, iban, bban, country_code, sepa_country, and printable_format. That gives you both a basic validity check and the formatted bank account details needed for storage, display, or downstream processing.

Use IBAN Validator when you need to reject bad bank details at signup, reduce payment failures, or clean account data before it reaches your finance system. It is a good fit for checkout forms, payout onboarding, and any validation step where you need to confirm the account number before submitting a transfer.

If the IBAN is valid, you can also use the returned country code and SEPA flag to branch logic by payment region or compliance path.

POST
Validate an IBAN
https://api.eu.apyverse.com/apyhub/validate-iban

QUICKSTART

GUIDE

Quickstart

Validate an IBAN by sending it in a JSON body.

curl -X POST "https://api.eu.apyverse.com/apyhub/validate-iban" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"iban":"FR7630006000011234567890189"}'

What you'll get back

Returns a JSON object with a data field. data is either an object with IBAN details and validation results, or false when the IBAN is invalid.

{
  "data": {
    "bban": "30006000011234567890189",
    "iban": "FR7630006000011234567890189",
    "valid": true,
    "country_code": "FR",
    "sepa_country": true,
    "printable_format": "FR76 3000 6000 0112 3456 7890 189"
  }
}
TRY ITLIVE · 5 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
The IBAN to validate.

About this endpoint

What it does

Validates an IBAN submitted in the request body. On success, it returns a JSON object with a data field that is either a detailed IBAN information object or a boolean false when the IBAN is invalid.

Request Body

ParameterTypeMandatoryDescription
ibanStringYesThe IBAN to validate.

Response

Returns a JSON object with a data field. The data value is either an object containing IBAN details or the boolean false when the IBAN is invalid.

ParameterTypeMandatoryDescription
dataObject / BooleanYesEither an object with IBAN details, or false when the IBAN is invalid.
data.bbanStringNoThe BBAN portion of the IBAN.
data.ibanStringNoThe IBAN.
data.validBooleanNoIndicates whether the IBAN is valid.
data.country_codeStringNoThe IBAN country code.
data.sepa_countryBooleanNoIndicates whether the country is a SEPA country.
data.printable_formatStringNoThe IBAN in printable format.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.