Darmowe API wykazu banków PL

Publiczne, bezpłatne API zwracające dane oddziału banku w Polsce na podstawie 8-cyfrowego numeru rozliczeniowego lub pełnego 26-cyfrowego numeru IBAN/NRB. Bez kluczy, bez rejestracji, format JSON, CORS włączony. Dane to kompilacja publicznego wykazu numerów rozliczeniowych NBP.

Część projektu KSeFek Burczymucha — darmowego programu do KSeF dla małych firm.

Endpoint:
GET https://ksefekburczymucha.pl/api/bank/{numer}
gdzie {numer} to 8-cyfrowy numer rozliczeniowy lub pełny 26-cyfrowy NRB.

Przykład

curl https://ksefekburczymucha.pl/api/bank/10101010

Odpowiedź:

{
  "numer": "10101010",
  "nazwa_banku": "Narodowy Bank Polski",
  "nazwa_oddzialu": "Oddział Okręgowy w Warszawie",
  "miejscowosc": "Warszawa",
  "ulica": "pl. Powstańców Warszawy 4",
  "found": true
}

Kody odpowiedzi

200 + found:true — znaleziono
200 + found:false — numer poprawny, brak w bazie
400 — zła długość lub niepoprawna cyfra kontrolna
429 — przekroczony limit (60/min, 2000/dobę) lub blokada

Limity

60 zapytań / minutę / IP
2000 zapytań / dobę / IP
5 zapytań o nieistniejący numer w 10 min = blokada na 1h

Delphi (THTTPClient)

uses System.Net.HttpClient, System.JSON;

var
  Http: THTTPClient;
  Resp: IHTTPResponse;
  J: TJSONObject;
begin
  Http := THTTPClient.Create;
  try
    Resp := Http.Get('https://ksefekburczymucha.pl/api/bank/10101010');
    J := TJSONObject.ParseJSONValue(Resp.ContentAsString) as TJSONObject;
    ShowMessage(J.GetValue<string>('nazwa_banku'));
  finally
    Http.Free;
  end;
end;

JavaScript

fetch('https://ksefekburczymucha.pl/api/bank/10101010')
  .then(r => r.json())
  .then(console.log);

Python

import requests
r = requests.get('https://ksefekburczymucha.pl/api/bank/10101010').json()
print(r['nazwa_banku'])

O projekcie

API powstało jako funkcja pomocnicza programu KSeFek — darmowego programu do KSeF (Krajowego Systemu e-Faktur). Brakowało takiego serwisu w polskim internecie, więc udostępniam go publicznie wszystkim, którzy walidują numery kont bankowych w swoich aplikacjach.

Źródło danych: kompilacja publicznych wykazów numerów rozliczeniowych NBP. Dane bez gwarancji aktualności. Brakujące wpisy uzupełniane są na bieżąco — jeśli zauważysz brak, daj znać.