Dokumentacja API do walidacji IBAN

API REST IBAN-Test sprawdza strukturę i cyfry kontrolne IBAN, zwraca dostępne dane bankowe i BIC, weryfikuje kody BIC i niemieckie rachunki bankowe oraz generuje IBAN na podstawie danych bankowych. Uwierzytelnij się tokenem API z panelu i wykorzystuj odpowiedzi JSON w formularzach, procesach płatności i systemach backendowych.

Wypróbuj weryfikator IBAN online · Skorzystaj z generatora IBAN · Połącz serwer MCP

Uwierzytelnianie

Użyj tokena z sekcji API overview jako tokena Bearer w nagłówku HTTP:

Authorization: Bearer YOUR_API_TOKEN

Po zalogowaniu token znajdziesz w sekcji API overview. Jeśli nie masz jeszcze konta, utwórz klucz API.

Bazowy adres URL

https://www.iban-test.eu/api

Endpointy

• GET /v2/iban/validate?iban=... – sprawdzanie IBAN
• GET /v2/iban/validate/{iban} – sprawdzanie IBAN przekazanego w ścieżce URL
• POST /v2/iban/validate – sprawdzanie IBAN przekazanego w treści żądania
• GET /v2/bic/validate/{bic} – sprawdzanie BIC
• GET /v2/bank-account/validate?bankcode=...&accountnumber=... – sprawdzanie niemieckiego rachunku bankowego
• GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... – generowanie IBAN

Co obejmuje weryfikacja IBAN

• Kod kraju, układ znaków i długość IBAN obowiązująca w danym kraju
• Cyfry kontrolne IBAN sprawdzane międzynarodowym algorytmem MOD-97
• Dostępne dane z rejestrów banków, takie jak nazwa banku, miejscowość i BIC

Pozytywny wynik potwierdza formalną poprawność IBAN. Nie dowodzi, że rachunek istnieje, należy do konkretnej osoby, jest aktywny lub może przyjmować płatności.

Przykłady żądań

Sprawdź IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate?iban=DE89%203704%200044%200532%200130%2000"

Spacje w IBAN są dozwolone i są automatycznie usuwane przed weryfikacją.

Sprawdź BIC

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Sprawdź rachunek bankowy

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bank-account/validate?bankcode=37040044&accountnumber=532013000"

Wygeneruj IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000"

Format odpowiedzi i obsługa błędów

Wszystkie endpointy zwracają JSON. Przed zaakceptowaniem lub zapisaniem danych bankowych sprawdź odpowiedź HTTP i pola error, code, message oraz opcjonalne pole details.

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

Aktualne parametry i schematy odpowiedzi znajdziesz w dokumentacji OpenAPI. Poprawna suma kontrolna IBAN nie potwierdza tożsamości właściciela rachunku.

{
  "details": {
    "sepa": {
      "sddCore": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sddB2b": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sct": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sctInst": {
        "status": "confirmed",
        "reason": "matched"
      }
    }
  }
}

MCP dla klientów AI

Oprócz API REST IBAN-Test udostępnia serwer Model Context Protocol do weryfikacji IBAN. MCP udostępnia te same funkcje bankowe jako ustrukturyzowane narzędzia dla zgodnych klientów i agentów AI.

https://www.iban-test.eu/mcp

Authorization: Bearer YOUR_API_TOKEN

Dostępne narzędzia MCP

• validate_iban – sprawdza pojedynczy IBAN
• validate_iban_batch – sprawdza wiele numerów IBAN; każdy numer liczy się jako jedno żądanie API
• generate_test_iban – generuje IBAN na podstawie kodu kraju, kodu banku i numeru rachunku
• ibantest_bank_account_validate – sprawdza niemiecki kod banku i numer rachunku
• ibantest_bic_validate – sprawdza BIC i zwraca dostępne dane bankowe
• get_usage_info – Pokazuje wykorzystanie API bez zużywania żądania weryfikacji.

Wywołania narzędzi funkcyjnych MCP są wliczane do limitu API IBAN-Test tak samo jak żądania REST.

Uwagi

• API REST i MCP używają tokenów Bearer.
• Ta dokumentacja nie obejmuje poprzedniej wersji API używającej kodu uwierzytelniającego.
• Żądania wykonujące funkcje usługi są wliczane do bieżącego limitu API.