apyhub
DATA VALIDATION · FINANCE

Validate IBAN API

Hosted on ApyHub

What it does

IBAN Validator checks whether a bank account identifier is a valid IBAN and returns the parsed details your application can use.

Send an iban string in the request body. The response is either false for an invalid value, or a data object containing iban, valid, country_code, sepa_country, bban, and printable_format. That gives you both a simple validity check and the normalized account string in one call.

Use IBAN Validator when you need to gate payment forms, clean up stored banking details, or reject malformed international account numbers before they reach downstream systems. The country_code and sepa_country fields help you branch logic for regional payment rules, while printable_format is useful for showing a formatted version back to users.

The service is narrow by design: it validates a single IBAN value and returns only the fields defined in the response schema. That makes it easy to drop into checkout flows, onboarding steps, and back-office validation jobs without extra parsing work.

POST
Validate an IBAN
http://localhost:8080/apyhub/validate-iban
QUICKSTARTGUIDE

Quickstart

Validate an IBAN by sending it in a simple JSON body.

curl -X POST "http://localhost:8080/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 can be either an object with IBAN details and a valid flag, or a boolean 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 and returns a JSON object under data. When the IBAN is valid, data contains IBAN details; when it is invalid, data is false.

Request Body

ParameterTypeMandatoryDescription
ibanStringYesThe IBAN to validate.

Response

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

ParameterTypeMandatoryDescription
dataObject / BooleanYesEither an object with bban, iban, valid, country_code, sepa_country, and printable_format fields, or false when the IBAN is invalid.

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.