Bank accounts
Get Bank Info By Iban
Looks up the BIC and bank name for an IBAN from an offline bank registry. bank_code and bank_name can be null when the bank isn't in the registry, which is common for EMIs and fintechs.
GET
/v1/bank-accounts/info-by-iban/Authorization
X-Api-Key
string required
API key generated in the Developers section of the Stablegate app. Send it in the
X-Api-Key header on every request; the partner API does not require request signing.Query parameters
iban
string required
IBAN to look up, spaces allowed
Responses
Successful Response
bank_name
string | null
Bank name. Null when the registry has no usable entry for the IBAN.
bank_code
string | null
Bank BIC. Null when the registry has no entry for the IBAN.
bank_country
string | null
ISO 3166-1 alpha-2 country code taken from the IBAN.
Validation Error
trace_id
string required
error_code
string required
One of:
devapi_internal_error, devapi_request_validation_error, devapi_iban_parse_error, devapi_customer_close_error, devapi_bank_code_required_error, devapi_download_aol_error, devapi_not_found_error, devapi_bad_request_error, devapi_email_occupied_error, devapi_idempotency_invalid_key, devapi_idempotency_key_misuse, devapi_idempotency_request_in_progress, devapi_kyc_application_link_error, devapi_instant_verification_error, devapi_unauthorized_error, devapi_forbidden_error, devapi_method_not_allowed_error, devapi_service_unavailable_errormessage
string required
details
object[] required
loc
string | string[] required
msg
string required
type
string required
curl 'https://api.stablegate.com/v1/bank-accounts/info-by-iban/?iban=string' \
--header 'X-Api-Key: YOUR_API_KEY'
{
"bank_name": "string",
"bank_code": "string",
"bank_country": "string"
}
{
"trace_id": "string",
"error_code": "devapi_internal_error",
"message": "string",
"details": [
{
"loc": "string",
"msg": "string",
"type": "string"
}
]
}