IBAN-BIC.com REST and HTTP Interface

https://www.iban-bic.com/withoutsoap.html
Admin
IBAN-BIC.com provides a REST and HTTP/HTTPS interface for its services, allowing users to validate...
Tokens:2,078
Snippets:9
Trust Score:7.4
Update:8 months ago
Show doc for...
Tokens:
Raw
### Generate QR Code API

Source: https://www.iban-bic.com/withoutsoap.html/index

Generates a QR code containing all information required for a SEPA transfer, useful for invoices.

```APIDOC
## POST /qrcode

### Description
Generates a QR code for SEPA transfers, which can be scanned by banking apps.

### Method
POST

### Endpoint
/qrcode

### Parameters
#### Query Parameters
- **recipient** (string) - Required - The name of the recipient.
- **iban** (string) - Required - The recipient's IBAN.
- **bic** (string) - Optional - The recipient's BIC.
- **amount** (string) - Optional - The transfer amount.
- **memo** (string) - Optional - A memo for the transfer.
- **label** (string) - Optional - A label for the transfer.
- **username** (string) - Required - Your username for authentication.
- **password** (string) - Required - Your password or its MD5 hash for authentication.

### Request Example
```json
{
  "recipient": "Example Company",
  "iban": "DE81270286000000000001",
  "amount": "100.00",
  "memo": "Invoice #12345",
  "username": "your_username",
  "password": "your_password_or_md5_hash"
}
```

### Response
#### Success Response (200)
- **qr_code_url** (string) - A URL to the generated QR code image.

#### Response Example
```json
{
  "qr_code_url": "https://example.com/qr/generated_qr_code.png"
}
```
```

--------------------------------

### SOAP Interface via HTTP/HTTPS

Source: https://www.iban-bic.com/withoutsoap.html/index

Accesses SOAP functionalities (IBAN calculation, validation, etc.) through a simple HTTP or HTTPS POST/GET request without needing a SOAP client.

```APIDOC
## HTTP/HTTPS Wrapper for SOAP Interface

### Description
This endpoint allows you to use the SOAP functions via a standard HTTP or HTTPS request. You send the function name and parameters as form data.

### Method
GET or POST

### Endpoint
`https://ssl.ibanrechner.de/http.html` or `http://ssl.ibanrechner.de/http.html`

### Parameters
#### Form Parameters
- **function** (string) - Required - The name of the SOAP function to call (e.g., `calculate_iban`, `validate_iban`).
- **username** (string) - Required - Your username.
- **password** (string) - Required - Your password or its MD5 hash.
- **version** (string) - Optional - Specifies a particular version of the SOAP interface (e.g., `12-2`).
- **[function_specific_parameters]** - Required/Optional - Parameters specific to the called function (refer to SOAP documentation for details).

### Request Example (calculate_iban)
```
POST /http.html HTTP/1.1
Host: ssl.ibanrechner.de
Content-Type: application/x-www-form-urlencoded

function=calculate_iban&username=someusername&password=md5("calculate_iban"."someusername"."648479930"."secret")&account=648479930
```

### Response
#### Success Response (200)
- The response is an XML file with a structure similar to the SOAP response.

#### Response Example (for calculate_iban)
```xml
<response>
  <iban>DE81270286000000000001</iban>
  <bic>DRESDEFFXXX</bic>
  <bank_name>Deutsche Bank AG</bank_name>
</response>
```

### Authentication (MD5 Hash)
Instead of sending your password in plain text, you can send an MD5 hash. The format is `md5("<function_name>"."<username>"."<account_or_iban>"."<password>")` for relevant functions. For `get_form`, the `params` parameter should be URL-encoded JSON.
```

--------------------------------

### Find Bank API

Source: https://www.iban-bic.com/withoutsoap.html/index

Searches the international bank directory using bank name, sort code, country, or BIC.

```APIDOC
## POST /find_bank

### Description
Searches the international bank directory based on provided bank details.

### Method
POST

### Endpoint
/find_bank

### Parameters
#### Query Parameters
- **search_terms** (string) - Required - The search query (e.g., bank name, sort code, country, BIC).
- **username** (string) - Required - Your username for authentication.
- **password** (string) - Required - Your password or its MD5 hash for authentication.

### Request Example
```json
{
  "search_terms": "Deutsche Bank, Frankfurt",
  "username": "your_username",
  "password": "your_password_or_md5_hash"
}
```

### Response
#### Success Response (200)
- **banks** (array) - A list of matching bank entries.
  - **bank_name** (string) - The name of the bank.
  - **bic** (string) - The BIC of the bank.
  - **country** (string) - The country where the bank is located.

#### Response Example
```json
{
  "banks": [
    {
      "bank_name": "Deutsche Bank AG",
      "bic": "DRESDEFFXXX",
      "country": "DE"
    }
  ]
}
```
```

--------------------------------

### IBAN Validation API

Source: https://www.iban-bic.com/withoutsoap.html/index

Validates IBANs, checks their correctness, and retrieves associated bank information such as BIC and bank name.

```APIDOC
## POST /validate_iban

### Description
Validates an IBAN, performs a series of checks, and returns information like BIC and bank name.

### Method
POST

### Endpoint
/validate_iban

### Parameters
#### Query Parameters
- **iban** (string) - Required - The IBAN to validate.
- **username** (string) - Required - Your username for authentication.
- **password** (string) - Required - Your password or its MD5 hash for authentication.

### Request Example
```json
{
  "iban": "DE81270286000000000001",
  "username": "your_username",
  "password": "your_password_or_md5_hash"
}
```

### Response
#### Success Response (200)
- **bic** (string) - The BIC of the bank associated with the IBAN.
- **bank_name** (string) - The name of the bank.
- **iban_valid** (boolean) - Indicates if the IBAN is valid.
- **country_code** (string) - The country code of the IBAN.

#### Response Example
```json
{
  "bic": "DRESDEFFXXX",
  "bank_name": "Deutsche Bank AG",
  "iban_valid": true,
  "country_code": "DE"
}
```
```

--------------------------------

### IBAN Calculation API

Source: https://www.iban-bic.com/withoutsoap.html/index

Converts a national bank account number (BBAN) into an IBAN, performs various checks, and provides additional information.

```APIDOC
## POST /calculate_iban

### Description
Converts a national bank account number into an IBAN, performs checks, and returns additional information.

### Method
POST

### Endpoint
/calculate_iban

### Parameters
#### Query Parameters
- **account** (string) - Required - The national bank account number.
- **bic** (string) - Optional - The BIC of the bank.
- **username** (string) - Required - Your username for authentication.
- **password** (string) - Required - Your password or its MD5 hash for authentication.

### Request Example
```json
{
  "account": "648479930",
  "bic": "DRESDEFFXXX",
  "username": "your_username",
  "password": "your_password_or_md5_hash"
}
```

### Response
#### Success Response (200)
- **iban** (string) - The generated IBAN.
- **bic** (string) - The BIC of the bank.
- **bank_name** (string) - The name of the bank.

#### Response Example
```json
{
  "iban": "DE81270286000000000001",
  "bic": "DRESDEFFXXX",
  "bank_name": "Deutsche Bank AG"
}
```
```
Tokens:
Raw