Links
🏦

IBAN Validation

Overview

The IBAN Validation endpoint in the Greip API allows you to validate International Bank Account Numbers (IBANs) and retrieve additional information about the country associated with the IBAN. This documentation provides details on how to use this endpoint and understand the JSON response it returns.
get
https://gregeoip.com
/validateIBAN
Method endpoint.

Method Parameters

Here's a list of all parameters can be used for this method:
Parameter
Description
key *
Your API Key.
iban *
The International Bank Account Number (IBAN) you want to validate.
Sample values: BE71096123456769
BE71 0961 2345 6769
format
The format of the API response. (JSON, XML, CSV or Newline)
callback
Tells the API to return the response as a callback function (Check out Callback section).
mode
Lets you use our Development Environment to test the API without affecting your available requests (Learn more).
All parameters with (*) are required.

Sample Response

{
"data": {
"isValid": true,
"formats": {
"machine": "BE71096123456769",
"human": "BE71 0961 2345 6769",
"obfuscated": "BE** **** **** 6769"
},
"country": {
"name": "Belgium",
"IANA": "be",
"ISO3166": "BE",
"currency": "EUR",
"centralBank": {
"url": "http://www.nbb.be/",
"name": "National Bank of Belgium"
},
"membership": "eu_member",
"isEU": true,
"length": "16",
"isSEPA": true,
"swiftOfficial": true
}
},
"status": "success",
"executionTime": 1
}

Response Possible Values

Key
Values
Description
data.isValid
Boolean
Determines whether the IBAN is valid
data.formats.machine
String
IBAN in machine format (without symbols or spaces)
data.formats.human
String
IBAN in human-readable format
data.formats.obfuscated
String
IBAN in ofuscated format (hidden)
data.country.name
String
IBAN country name
data.country.IANA
String
The country code top-level domains (ccTLDs)
data.country.ISO3166
Boolean
IBAN country code (ISO3166)
data.country.currency
String
IBAN country official currency
data.country.centralBank.url
String
IBAN country central bank URL
data.country.centralBank.name
String
IBAN country central bank name
data.country.membership
String
IBAN country membership
data.country.isEU
Boolean
Membership type of the country Membership types: - EU-Member States (eu_member) - EFTA-Member States (efta_member) - Other Memberships, which have monetary agreements with the EU (other_member) - Non-Members, which don't belong to the EU or have agreements (non_member)
data.country.length
Integer
IBAN length for the country
data.country.isSEPA
Boolean
Determines whether the IBAN country is a member of SEPA (Single Euro Payments Area)
data.country.swiftOfficial
Boolean
Determines whether the IBAN country is an official, SWIFT issued country record