IBAN Generator API Documentation

Use the following APIs to generate and validate IBANs. Both APIs support processing up to 1000 IBANs at a time.

Important: All API requests require an API key. You can find your API key on your profile page.

Authentication

Include your API key in the header of each request:

X-API-Key: your_api_key_here

1. IBAN Generation API

Endpoint

POST /api/v1/generate

Request

Send a JSON payload with the following parameters:

country: The country for which the IBAN should be generated (e.g., "Turkey")
quantity: The number of IBANs to generate (max 1000)

{
    "country": "Turkey",
    "quantity": 1
}

Response

The response will be a JSON array with the generated IBANs and their validation status.

[
    {
        "iban": "TRXXXXXXXXXXXXXXXXXXXXX",
        "valid": true,
        "swift_code": "TGBATRIS",
        "bank_name": "TURKIYE GARANTI BANKASI A.S.",
        "bank_city": "ISTANBUL"
    }
]

Example usage

cURL


curl -X POST https://ibangen.com/api/v1/generate \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{"country": "Turkey", "quantity": 1}'

PowerShell


$headers = @{
    "Content-Type" = "application/json"
    "X-API-Key" = "your_api_key_here"
}

$body = @{
    country = "Turkey"
    quantity = 1
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://ibangen.com/api/v1/generate" -Method Post -Body $body -Headers $headers

Python


import requests
import json

url = "https://ibangen.com/api/v1/generate"
payload = {
    "country": "Turkey",
    "quantity": 1
}
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "your_api_key_here"
}

response = requests.post(url, data=json.dumps(payload), headers=headers)
print(response.json())

JavaScript (Node.js)


const axios = require('axios');

const url = 'https://ibangen.com/api/v1/generate';
const payload = {
    country: 'Turkey',
    quantity: 1
};
const headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error));

PHP


 'Turkey',
    'quantity' => 1
);

$options = array(
    'http' => array(
        'header'  => "Content-type: application/json\r\n" .
                     "X-API-Key: your_api_key_here\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

print_r(json_decode($result));
?>

2. IBAN Validation API

Endpoint

POST /api/v1/validate

Request

Send a JSON payload with an array of IBANs to validate:

{
    "ibans": ["IBAN1", "IBAN2", "IBAN3"]
}

Response

The response will be a JSON array with the validation results for each IBAN.

[
    {
        "iban": "IBAN1",
        "valid": true,
        "swift_code": "SWIFT1",
        "bank_name": "Bank Name 1",
        "bank_city": "City 1"
    },
    {
        "iban": "IBAN2",
        "valid": false,
        "swift_code": "N/A",
        "bank_name": "N/A",
        "bank_city": "N/A",
        "error": "Invalid IBAN structure"
    },
    {
        "iban": "IBAN3",
        "valid": true,
        "swift_code": "SWIFT3",
        "bank_name": "Bank Name 3",
        "bank_city": "City 3"
    }
]

Example usage

cURL


curl -X POST https://ibangen.com/api/v1/validate \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{"ibans": ["GB82WEST12345698765432", "DE89370400440532013000", "FR7630006000011234567890189"]}'

PowerShell


$headers = @{
    "Content-Type" = "application/json"
    "X-API-Key" = "your_api_key_here"
}

$body = @{
    ibans = @("GB82WEST12345698765432", "DE89370400440532013000", "FR7630006000011234567890189")
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://ibangen.com/api/v1/validate" -Method Post -Body $body -Headers $headers

Python


import requests
import json

url = "https://ibangen.com/api/v1/validate"
payload = {
    "ibans": ["GB82WEST12345698765432", "DE89370400440532013000", "FR7630006000011234567890189"]
}
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "your_api_key_here"
}

response = requests.post(url, data=json.dumps(payload), headers=headers)
print(response.json())

JavaScript (Node.js)


const axios = require('axios');

const url = 'https://ibangen.com/api/v1/validate';
const payload = {
    ibans: ['GB82WEST12345698765432', 'DE89370400440532013000', 'FR7630006000011234567890189']
};
const headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error));

PHP


 array('GB82WEST12345698765432', 'DE89370400440532013000', 'FR7630006000011234567890189')
);

$options = array(
    'http' => array(
        'header'  => "Content-type: application/json\r\n" .
                     "X-API-Key: your_api_key_here\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

print_r(json_decode($result));
?>

3. Profile Generation API

Endpoint

POST /api/v1/profile

Request

Send a JSON payload with the following parameters:

country: (Required) The country for which the profile should be generated (e.g., "Turkey")
gender: (Optional) The gender of the profile ("male", "female", or "random"). Default: "random"
age_min: (Optional) The minimum age of the profile. Default: 18
age_max: (Optional) The maximum age of the profile. Default: 80

{
    "country": "Turkey",
    "gender": "female",  // Optional, defaults to "random"
    "age_min": 25,       // Optional, defaults to 18
    "age_max": 45        // Optional, defaults to 80
}

Minimal Request Example

{
    "country": "Turkey"
}

Response

The response will be a JSON object with the generated profile.

{
    "success": true,
    "profile": {
        "first_name": "Anna",
        "last_name": "Schmidt",
        "gender": "female",
        "date_of_birth": "1987-05-12",
        "age": 36,
        "email": "[email protected]",
        "phone": "+49 177 4322109",
        "address": {
            "street": "Berlinerstraße 42",
            "postal_code": "10115",
            "city": "Berlin",
            "country": "Germany"
        },
        "occupation": "Architect",
        "tax_id": "76 325 614 892",
        "ssn": "76325614892",
        "credit_card": {
            "type": "Visa",
            "number": "4111 XXXX XXXX 1234",
            "expiry": "06/25",
            "cvv": "***"
        }
    },
    "generations_left": 9
}

Example usage

cURL


curl -X POST https://ibangen.com/api/v1/profile \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{"country": "Turkey", "gender": "female", "age_min": 25, "age_max": 45}'

PowerShell


$headers = @{
    "Content-Type" = "application/json"
    "X-API-Key" = "your_api_key_here"
}

$body = @{
    country = "Turkey"
    gender = "female"
    age_min = 25
    age_max = 45
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://ibangen.com/api/v1/profile" -Method Post -Body $body -Headers $headers

Python


import requests
import json

url = "https://ibangen.com/api/v1/profile"
payload = {
    "country": "Turkey",
    "gender": "female",
    "age_min": 25,
    "age_max": 45
}
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "your_api_key_here"
}

response = requests.post(url, data=json.dumps(payload), headers=headers)
print(response.json())

JavaScript (Node.js)


const axios = require('axios');

const url = 'https://ibangen.com/api/v1/profile';
const payload = {
    country: 'Turkey',
    gender: 'female',
    age_min: 25,
    age_max: 45
};
const headers = {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error));

PHP


 'Turkey',
    'gender' => 'female',
    'age_min' => 25,
    'age_max' => 45
);

$options = array(
    'http' => array(
        'header'  => "Content-type: application/json\r\n" .
                     "X-API-Key: your_api_key_here\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

print_r(json_decode($result));
?>

4. General Information

API IBAN Generator provides access to the following functions:

Generating IBAN numbers for different countries
Validating existing IBAN numbers
Generating profiles with personal information

API Limits:

Basic plan: 100 requests
Unlimited plan: Unlimited

Use of API for mass generation of personal data must comply with data privacy laws in your jurisdiction.