Baza wiedzy o serwisach administracji publicznej

Dane z CRBR można pobierać automatycznie przez publiczną usługę sieciową Ministerstwa Finansów. To rozwiązanie dla organizacji i firm, które regularnie weryfikują kontrahentów, oraz dla twórców narzędzi analitycznych i watchdogowych. Opis pochodzi ze specyfikacji „Usługa API do udostępniania danych z systemu CRBR – Specyfikacja Wejścia-Wyjścia”, wersja 3.0.4 z 9 marca 2023 r.

Jaki jest adres usługi API CRBR?

Usługa ApiPrzegladoweCRBR działa w standardzie SOAP 1.2 i jest dostępna publicznie pod adresem:

https://bramkacrbr.mf.gov.pl:5058/uslugiBiznesowe/uslugiESB/AP/ApiPrzegladoweCRBR/2022/12/01

Komunikaty żądania i odpowiedzi muszą być zgodne ze standardem SOAP 1.2 i aktualnym schematem XML. Plik WSDL i przykładowy projekt znajdziesz w zakładce „Do pobrania” na stronie CRBR w serwisie gov.pl.

Jaka operacja jest dostępna?

Usługa udostępnia operację PobierzInformacjeOSpolkachIBeneficjentach. Wyszukuje ona w rejestrze informacje o podmiotach i ich beneficjentach rzeczywistych według kryteriów przekazanych przez system zewnętrzny.

Jakie kryteria wyszukiwania można podać?

W elemencie SzczegolyWniosku można przekazać:

• NIP – NIP podmiotu, dla którego mają zostać zwrócone informacje o nim i jego beneficjentach,
• KRS – numer w Krajowym Rejestrze Sądowym,
• Nazwa – nazwa podmiotu (co najmniej 2 znaki),
• PESEL – numer PESEL osoby, dla której mają zostać zwrócone podmioty, w których jest beneficjentem,
• DataUrodzenia, PierwszeImie, Nazwisko – dane osoby bez numeru PESEL,
• DataOd i DataDo – zakres dat (włącznie), za który mają zostać zwrócone informacje.

Co zawiera odpowiedź?

Odpowiedź PobierzInformacjeOSpolkachIBeneficjentachOdpowiedz zawiera między innymi:

• IdentyfikatorWniosku – unikalny identyfikator nadany przez system,
• DataICzasZlozeniaWniosku i DataICzasUdostepnieniaWniosku,
• ListaInformacjiOSpolkachIBeneficjentach – dla każdego podmiotu nazwę, NIP, KRS, kod i opis formy organizacyjnej oraz dane beneficjentów,
• SzczegolyWniosku – powtórzenie kryteriów z zapytania,
• Status – wynik zapytania, na przykład „IstniejaInformacje”,
• CelZapytania – charakter udostępnionych informacji.

Błędy są zwracane jako SOAP Fault zgodny ze specyfikacją SOAP 1.2.

Przykład zapytania po NIP

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:ns="http://www.mf.gov.pl/uslugiBiznesowe/uslugiESB/AP/ApiPrzegladoweCRBR/2022/12/01"
  xmlns:ns1="http://www.mf.gov.pl/schematy/AP/ApiPrzegladoweCRBR/2022/12/01">
  <soap:Header/>
  <soap:Body>
    <ns:PobierzInformacjeOSpolkachIBeneficjentach>
      <PobierzInformacjeOSpolkachIBeneficjentachDane>
        <ns1:SzczegolyWniosku>
          <ns1:NIP>1234567890</ns1:NIP>
        </ns1:SzczegolyWniosku>
      </PobierzInformacjeOSpolkachIBeneficjentachDane>
    </ns:PobierzInformacjeOSpolkachIBeneficjentach>
  </soap:Body>
</soap:Envelope>

Przykład odpowiada wzorowi ze specyfikacji (z przykładowym numerem NIP). Przed wdrożeniem porównaj go z aktualnym plikiem WSDL.

Dobra praktyka. Zapisuj identyfikator wniosku i datę udostępnienia razem z wynikiem. Pozwala to później wykazać, jakie dane były w rejestrze w chwili weryfikacji. Pamiętaj też o planowanej zmianie zasad dostępu do CRBR – po wejściu nowelizacji w życie warunki korzystania z usługi mogą się zmienić.

API KRS i API CRBR – jak je połączyć?

CRBR nie zawiera pełnych danych rejestrowych ani informacji o wykreśleniu. Dlatego wyniki warto łączyć z danymi z otwartego API KRS, opisanego w artykule Jak pobierać dane z KRS przez otwarte API?.

Stan na 11 października 2026 r. Artykuł ma charakter informacyjny i nie stanowi porady prawnej.

Źródło: opracowano na podstawie materiałów Ministerstwa Finansów (gov.pl/web/finanse, crbr.podatki.gov.pl) udostępnianych na licencji CC BY-SA 4.0. Treść została przeredagowana i uzupełniona; artykuł udostępniamy na tej samej licencji.