O tym API
BIR1.1 (Baza Internetowa REGON) to usługa GUS udostępniająca dane rejestrowe każdego podmiotu gospodarczego w Polsce — nazwę, formę prawną, adres, PKD, daty rejestracji. To jedno z najstarszych publicznych API w Polsce, stąd nietypowy dla dzisiejszych standardów protokół SOAP zamiast REST.
Najczęstsze pytania
Czy trzeba mieć klucz API?
Tak, tzw. USER_KEY — bezpłatny, ale trzeba go zamówić mailowo u administratorów REGON (regon_bir@stat.gov.pl). Dostępny jest też publiczny klucz testowy do wypróbowania usługi.
Jakie dane zwraca to API?
Pełne dane rejestrowe REGON: nazwę, formę prawną, adres, kody PKD, daty rozpoczęcia/zawieszenia/wykreślenia działalności — po podaniu NIP, REGON lub KRS.
Dlaczego to API używa SOAP, a nie REST/JSON jak reszta katalogu?
BIR1.1 to starsza usługa, zaprojektowana zgodnie ze standardami obowiązującymi w administracji publicznej sprzed ery powszechnego REST-a. Wywołanie wymaga sekwencji Zaloguj → Szukaj → PobierzPelnyRaport → Wyloguj.
Kto prowadzi to API?
Główny Urząd Statystyczny. Pełna dokumentacja techniczna jest dostępna pod api.stat.gov.pl/Home/RegonApi.