Fetch bank information by BIC, IBAN, or NID

Retrieve detailed bank information using one of three identifier types: NID (9-digit routing number), BIC (SWIFT code), or IBAN.

Format rules per bankIdType:

  • NID: Exactly 9 numeric digits. No all-zeros. (e.g., "021000021")
  • BIC: 8 or 11 alphanumeric characters (A-Z, 0-9). No all-zeros. (e.g., "DEUTDEFF" or "DEUTDEFFXXX")
  • IBAN: Up to 34 alphanumeric characters (A-Z, 0-9). No all-zeros. countryCode is REQUIRED when bankIdType is IBAN. First 2 characters of IBAN must match countryCode.
SecurityoAuth2
Request
query Parameters
bankId
required
string <= 34 characters

The bank identifier. Format depends on bankIdType:

  • NID: Exactly 9 digits (0-9). No all-zeros.
  • BIC: 8 or 11 alphanumeric chars (A-Z, 0-9). No all-zeros.
  • IBAN: Up to 34 alphanumeric chars. First 2 chars must match countryCode. No all-zeros.
bankIdType
required
string

The type of bank identifier. When set to "IBAN", countryCode is required.

Enum: "NID" "BIC" "IBAN"
countryCode
string^[a-zA-Z]+$

Required only when bankIdType is "IBAN". The ISO 3166 country code.

Responses
200

Successful response

400

Bad request — missing/invalid parameters, validation failure, or bank not found.

401

You are not authorized to access the resource

403

Accessing the resource you were trying to reach is forbidden

404

The resource you were trying to reach is not found

405

bad input parameter environment

500

Internal Server Error - Unexpected error occurred while processing the request

503

Service unavailable

get/v1/banks
Request samples 
Response samples 
application/json
{
  • "data": {
    }
}