Skip to main content
GET
/
api
/
v1
/
accounts
/
utils
/
iban
/
{iban}
Validate IBAN
curl --request GET \
  --url https://api.hevn.finance/api/v1/accounts/utils/iban/{iban}
{
  "id": "<string>",
  "account_number": "<string>",
  "national_bank_code": "<string>",
  "national_branch_code": "<string>",
  "bic": {
    "id": "<string>",
    "parsed_address": {
      "streetAddress": "<string>",
      "addressLine2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    },
    "address": "<string>",
    "postcode": "<string>",
    "branch_name": "<string>",
    "branch_code": "<string>",
    "country": {
      "id": "<string>",
      "name": "<string>"
    },
    "city": {
      "id": "<string>",
      "country_id": "<string>",
      "name": "<string>"
    },
    "bank": {
      "id": "<string>",
      "country_id": "<string>",
      "code": "<string>",
      "name": "<string>"
    }
  },
  "country": {
    "id": "<string>",
    "name": "<string>"
  }
}

Path Parameters

iban
string
required

Response

Successful Response

IBAN validation response from Fincodes API.

id
string
required
account_number
string | null
national_bank_code
string | null
national_branch_code
string | null
bic
BicInfoResponse · object

BIC lookup response from Fincodes API.

country
FincodesCountry · object