Generate Random IBAN

API-Dokumentation

Erzeugen und prüfen Sie strukturell gültige Test-IBANs (ISO 13616, MOD-97) über HTTP. Jede Antwort ist JSON. Generierte IBANs sind Testdaten: Keine Bank hat sie ausgegeben.

Basis-URL

https://generaterandomiban.com/api/v1

Authentifizierung

Jeder Endpunkt außer dem Dienstindex braucht einen API-Schlüssel. Senden Sie ihn im Header X-API-Key (Authorization: Bearer funktioniert ebenfalls). Bewahren Sie den Schlüssel auf Ihrem Server auf und liefern Sie ihn nie in clientseitigem Code aus.

curl -H "X-API-Key: YOUR_KEY" https://generaterandomiban.com/api/v1/countries

Schlüssel werden von Hand vergeben. Schicken Sie uns per E-Mail eine kurze Beschreibung Ihres Anwendungsfalls, und wir senden Ihnen einen zu.

apis@generaterandomiban.com

Rate-Limits

Die Limits gelten pro Schlüssel: standardmäßig 60 Anfragen pro Minute oder das individuelle Limit Ihres Schlüssels. Oberhalb des Limits antwortet die API mit HTTP 429 (Too Many Requests).

Endpunkte

GET /api/v1 Öffentlich

Dienstindex mit Metadaten und der Liste der Endpunkte. Kein API-Schlüssel nötig.

Beispielanfrage
curl https://generaterandomiban.com/api/v1
Beispielantwort
{
  "name": "Generate Random IBAN API",
  "version": "v1",
  "documentation": "https://generaterandomiban.com/de/apis/docs",
  "authentication": { "type": "api_key", "header": "X-API-Key" }
}

GET /api/v1/countries

Alle unterstützten Länder mit ihrem IBAN-Format.

Beispielanfrage
curl -H "X-API-Key: YOUR_KEY" https://generaterandomiban.com/api/v1/countries
Beispielantwort
{
  "count": 91,
  "countries": [
    {
      "code": "DE",
      "name": "Germany",
      "slug": "germany",
      "iban_length": 22,
      "bban_length": 18,
      "bban_format": "8n10n",
      "structure": "DEkk bbbb bbbb cccc cccc cc",
      "example": "DE89370400440532013000"
    }
  ]
}

GET /api/v1/countries/{code}

Das IBAN-Format eines Landes.

Parameter In Beschreibung
code path Ländercode nach ISO 3166-1 alpha-2, zum Beispiel DE, FR oder IT.
Beispielanfrage
curl -H "X-API-Key: YOUR_KEY" https://generaterandomiban.com/api/v1/countries/DE
Beispielantwort
{
  "country": {
    "code": "DE",
    "name": "Germany",
    "iban_length": 22,
    "bban_format": "8n10n",
    "example": "DE89370400440532013000"
  }
}

GET /api/v1/generate/{country}

Eine oder mehrere zufällige, gültige IBANs für ein Land erzeugen.

Nationale Prüfziffern (etwa die französische clé RIB, der italienische CIN oder der spanische DC) werden in beiden Modi berechnet. Keine Bank hat die realistischen IBANs ausgegeben, eine davon könnte aber zufällig zu einem echten Konto passen: Verwenden Sie sie nie für Zahlungen.

Parameter In Beschreibung
country path Ländercode nach ISO 3166-1 alpha-2.
count query Anzahl der zurückgegebenen IBANs, von 1 bis 100. Standard: 1.
realistic query Optional. 1 oder true für realistische IBANs: nur Ziffern und, wo verfügbar, der echte Bankcode einer großen Bank, mit zufälliger Kontonummer. 0 oder false für vollständig zufällige IBANs, mit Buchstaben, wo das Format sie erlaubt. Standard: 1.
Beispielanfrage
curl -H "X-API-Key: YOUR_KEY" "https://generaterandomiban.com/api/v1/generate/DE?count=2"
Beispielantwort
{
  "country": { "code": "DE", "name": "Germany", "iban_length": 22 },
  "count": 2,
  "realistic": true,
  "ibans": [
    {
      "iban": "DE89370400440532013000",
      "formatted": "DE89 3704 0044 0532 0130 00",
      "country": "DE",
      "check_digits": "89",
      "bban": "370400440532013000",
      "length": 22,
      "valid": true
    }
  ]
}

POST /api/v1/generate

IBANs mit den Parametern in einem JSON-Body erzeugen.

Parameter In Beschreibung
country body Ländercode nach ISO 3166-1 alpha-2. Pflichtfeld.
count body Anzahl der zurückgegebenen IBANs, von 1 bis 100. Standard: 1.
realistic body Optionaler Boolean, wie der Query-Parameter realistic. Standard: true.
Beispielanfrage
curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"FR","count":3,"realistic":true}' https://generaterandomiban.com/api/v1/generate
Beispielantwort
{
  "country": { "code": "FR", "name": "France", "iban_length": 27 },
  "count": 3,
  "realistic": true,
  "ibans": [ /* … */ ]
}

GET /api/v1/validate/{iban}

Eine IBAN prüfen, die ohne Leerzeichen in der URL übergeben wird.

Parameter In Beschreibung
iban path Die zu prüfende IBAN, nur Buchstaben und Ziffern.
Beispielanfrage
curl -H "X-API-Key: YOUR_KEY" https://generaterandomiban.com/api/v1/validate/DE89370400440532013000
Beispielantwort
{
  "iban": "DE89370400440532013000",
  "valid": true,
  "country_code": "DE",
  "country_supported": true,
  "check_digits": "89",
  "bban": "370400440532013000",
  "length": 22,
  "expected_length": 22,
  "checks": { "mod97": true, "length": true, "format": true, "country_supported": true }
}

POST /api/v1/validate

Eine IBAN prüfen, die in einem JSON-Body gesendet wird. Leerzeichen sind erlaubt.

Parameter In Beschreibung
iban body Die zu prüfende IBAN. Pflichtfeld.
Beispielanfrage
curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89 3704 0044 0532 0130 00"}' https://generaterandomiban.com/api/v1/validate
Beispielantwort
{
  "iban": "DE89370400440532013000",
  "valid": true,
  "country_code": "DE",
  "checks": { "mod97": true, "length": true, "format": true, "country_supported": true }
}

Fehler und Statuscodes

Fehler verwenden Standard-HTTP-Statuscodes und einen JSON-Body mit einem error-Objekt, das einen code und eine message enthält. Die häufigsten sind 401 (fehlender oder ungültiger Schlüssel), 404 (unbekanntes Land oder unbekannter Endpunkt), 422 (ungültige Parameter) und 429 (Rate-Limit überschritten).

{
  "error": {
    "code": "invalid_request",
    "message": "The \"count\" parameter must be an integer between 1 and 100."
  }
}

Liste herunterladen (ohne Schlüssel)

Der Generator liefert auch eine Datei: bis zu 100 IBANs eines Landes als CSV, JSON, SQL (INSERT-Anweisungen) oder reiner Text, mit einer Spalte pro BBAN-Segment. Dafür ist kein API-Schlüssel nötig, erlaubt sind 30 Downloads pro Minute.

Parameter In Beschreibung
countrypathLändercode nach ISO 3166-1 alpha-2.
formatquerycsv, json, sql oder txt. Standard: csv.
countqueryAnzahl der IBANs, von 1 bis 100. Standard: 10.
realisticquery1 für realistische IBANs, 0 für vollständig zufällige. Standard: 1.
Beispielanfrage
curl -OJ "https://generaterandomiban.com/export/de?format=csv&count=50"
Beispielantwort
iban,iban_print,country,check_digits,bank,account
DE89370400440532013000,DE89 3704 0044 0532 0130 00,DE,89,37040044,0532013000

MCP-Server

KI-Agenten können dieselben Funktionen über einen Model-Context-Protocol-Server unter /mcp nutzen (Streamable HTTP, JSON-RPC 2.0). Er ist öffentlich, braucht keinen API-Schlüssel und akzeptiert bis zu 120 Anfragen pro Minute.

Tool Beschreibung
list_countriesDie unterstützten Länder mit ihrer IBAN-Länge auflisten.
generate_iban1 bis 100 Test-IBANs für ein Land erzeugen.
validate_ibanEine IBAN prüfen: MOD-97, erwartete Länge und Länderunterstützung.
Beispielanfrage
curl -X POST https://generaterandomiban.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"generate_iban","arguments":{"country":"IT","count":2}}}'

generate_iban akzeptiert auch "realistic", Standardwert true. Übergeben Sie "realistic": false für vollständig zufällige IBANs.

Server-Card zur Erkennung: /.well-known/mcp/server-card.json

OpenAPI-Spezifikation

Eine maschinenlesbare OpenAPI-3.1-Beschreibung der REST-API, für Client-Generatoren und API-Tools: /api/v1/openapi.json

JavaScript-Bibliothek

Um IBANs im Browser oder offline zu prüfen, ohne die API aufzurufen, nutzen Sie unser Open-Source-Paket iban-check für JavaScript und TypeScript (keine Abhängigkeiten, MIT-Lizenz): GitHub · npm

Terminal
npm install iban-check

API-Schlüssel erhalten

Schlüssel werden von Hand vergeben. Schicken Sie uns per E-Mail eine kurze Beschreibung Ihres Anwendungsfalls, und wir senden Ihnen einen zu.

API-Schlüssel anfragen