Validate IBAN (Basic)

Credits: 1 per call

A lightweight validation that checks the IBAN format and checksum without looking up bank details. Returns country info, SEPA scheme support, and the extracted BBAN and account number.

Request

string

required

The IBAN to validate.

GET /services/iban/validate-basic/{iban}

Both GET and POST methods are supported.

curl -X GET "https://api.edge.bh/api/v1/services/iban/validate-basic/DE89370400440532013000" \
  -H "Authorization: Bearer sk_live_your_key_here"

import requests

response = requests.get(
    "https://api.edge.bh/api/v1/services/iban/validate-basic/DE89370400440532013000",
    headers={"Authorization": "Bearer sk_live_your_key_here"}
)
data = response.json()

Response

integer

200 if the IBAN is valid, 400 if it is not.

string

"IBAN is valid" or "IBAN is not valid".

array

Array of validation checks performed. Each item has code and message.

object

Parsed IBAN data.

Show child attributes

string

The normalized IBAN (spaces removed, uppercased).

string

ISO 3166-1 alpha-2 country code.

string | null

Country name.

string | null

ISO 4217 currency code.

object

SEPA scheme support details.

Show child attributes

boolean

Whether the country is a SEPA member.

boolean

Supports SEPA Credit Transfer.

boolean

Supports SEPA Direct Debit.

boolean

Supports SEPA COR1.

boolean

Supports SEPA B2B.

boolean

Supports SEPA Card Clearing.

string

Basic Bank Account Number.

string | null

Account number extracted from the IBAN.

Example response (valid IBAN):

{
  "result": 200,
  "message": "IBAN is valid",
  "validations": [
    { "code": "006", "message": "IBAN does not contain illegal characters" },
    { "code": "007", "message": "Country supports IBAN standard" },
    { "code": "003", "message": "IBAN Length is correct" },
    { "code": "005", "message": "IBAN structure is correct" },
    { "code": "001", "message": "IBAN Check digit is correct" },
    { "code": "002", "message": "Account Number check digit is correct" }
  ],
  "data": {
    "iban": "DE89370400440532013000",
    "country_code": "DE",
    "country_name": "Germany",
    "currency_code": "EUR",
    "sepa": {
      "member": true,
      "sepa_credit_transfer": true,
      "sepa_direct_debit": true,
      "sepa_cor1": true,
      "sepa_b2b": true,
      "sepa_card_clearing": true
    },
    "bban": "370400440532013000",
    "bank_account": "0532013000"
  }
}

Example response (invalid IBAN):

{
  "result": 400,
  "message": "IBAN is not valid",
  "validations": [
    { "code": "006", "message": "IBAN does not contain illegal characters" },
    { "code": "007", "message": "Country does not support IBAN standard" }
  ],
  "data": {
    "iban": "XX12345678",
    "country_code": "XX",
    "country_name": null,
    "currency_code": null,
    "sepa": {
      "member": false,
      "sepa_credit_transfer": false,
      "sepa_direct_debit": false,
      "sepa_cor1": false,
      "sepa_b2b": false,
      "sepa_card_clearing": false
    },
    "bban": "345678",
    "bank_account": null
  }
}

Overview

Credits

IBAN Validation

Sanctions Screening

Exchange Rates

Bank Directory

Commercial Registry

Country Data

Email Validation

Phone Validation

Validate IBAN (Basic)

Validate IBAN (Basic)

Request

Response

​Validate IBAN (Basic)

​Request

​Response

Validate IBAN (Basic)

Request

Response