Dokumentacja registerAPI

Jedno API do list sankcyjnych, PEP/RCA i rejestrów KRS, CRBR, CEIDG. Wybierz sposób korzystania:

Wszystkie systemy działają — zobacz stan usługi →

SecureAPI – szyfrowane zapytania

Twoja aplikacja i registerAPI mają po parze kluczy X25519. Wspólny klucz szyfrujący (HKDF-SHA256, AES-256-GCM) każda strona liczy z własnego klucza tajnego i cudzego publicznego – klucze tajne nigdy nie są przesyłane. Aplikacja szyfruje zapytanie (metodę, ścieżkę, parametry, treść) i wysyła kopertę na POST /secure, a registerAPI odsyła zaszyfrowaną odpowiedź. W ruchu sieciowym i w logach widać tylko /secure.

Wygeneruj parę kluczy w swojej aplikacji (PHP: sodium_crypto_box_keypair(), Python: biblioteka cryptography).
W portalu (Klucze API → SecureAPI) wklej klucz publiczny aplikacji. Możesz wymagać SecureAPI – jawne zapytania tym kluczem będą odrzucane.
Użyj gotowego klienta (PHP lub Python) – przekażemy go razem z kluczem publicznym serwera.

Koperta ma znacznik czasu (maks. 5 minut różnicy) i jednorazowy nonce. registerAPI przechowuje tylko szyfrogramy i odcisk HMAC treści, dzięki któremu powtórzone zapytanie płatne w ciągu 24 godzin jest podawane z pamięci, bez ponownej opłaty.

Jak pobieramy pełne dane spółek. Pełne dane KRS (z danymi osób) oraz oficjalne wydruki PDF z KRS i CRBR pobieramy na Twoje zlecenie. Zapytanie wysyłamy z konta registerAPI i przekazujemy tylko to, co potrzebne do wyszukania (NIP, numer KRS, imię i nazwisko) – bez nazwy Twojej firmy, klucza API i danych Twojego klienta. Listy sankcyjne, baza PEP/RCA, biała lista VAT i CEIDG działają u nas bezpośrednio.

Endpointy, stan i ceny (netto)

Pełny stan usługi →

Kolumna „Stan" aktualizuje się na bieżąco. Endpointy list sankcyjnych i PEP/RCA działają na danych własnych registerAPI, niezależnie od systemów krajowych; endpointy rejestrowe zależą od dostępności KRS, CRBR, CEIDG i białej listy VAT.

Metoda	Ścieżka	Opis	Stan	Cena
POST	/sanctions/check	Osoba lub firma na 14 listach sankcyjnych (MSWiA, GIIF, UE, 833/2014, 765/2006, ONZ, OFAC SDN i non-SDN, UK Sanctions List, SECO, Francja DG Trésor, Kanada, Australia DFAT, Ukraina RNBO), na liście ostrzeżeń publicznych KNF oraz w rejestrze kar administracyjnych za naruszenia ustawy AML (MF, GIIF, KNF, NBP).	Działa	0,10 zł
POST	/sanctions/check-batch	Do 500 sprawdzeń w jednym zapytaniu (opłata za każdą pozycję).	Działa	0,10 zł
GET	/sanctions/lists	Stan list: liczba pozycji i data aktualizacji (bezpłatnie).	Działa	bezpłatnie
POST	/pep/verify	PEP, członek rodziny PEP albo bliski współpracownik (RCA).	Działa	0,10 zł
POST	/pep/verify-batch	Do 200 osób w jednym zapytaniu.	Działa	0,10 zł
POST	/registers/report	Raport z białej listy VAT, KRS, CRBR i CEIDG z oficjalnych API, PDF z czasem pobrania i SHA-256. Także firmy z Czech (IČO), Francji (SIREN), Rumunii (CUI) i Belgii (KBO) – pole kraj.	Działa	0,10 zł
POST	/verify-company	Pełny raport spółki: KRS z danymi osób, CRBR, CEIDG, listy, ocena ryzyka.	Działa	0,10 zł
GET	/getpdf_krs/{id}, /getpdf_crbr/{id}, /getpdf_ceidg/{id}	Wydruki PDF do akt: KRS (wydruk od dostawcy), CRBR i CEIDG (zestawienie danych z oficjalnych API z czasem pobrania i SHA-256).	Działa	0,10 zł

Odpisy KRS: pamięć podręczna i aktualność

W raporcie z rejestrów (POST /registers/report) odpis KRS pobrany z API Ministerstwa Sprawiedliwości zapisujemy w pamięci podręcznej. Kolejne zapytanie o tę samą spółkę dostaje zapisany odpis, dopóki w KRS nie pojawi się nowy wpis dla tej spółki. Dzięki temu raport jest szybszy i nie zależy od przerw technicznych KRS.

Unieważnianie: co godzinę w ciągu dnia (6:00–22:00, a także o 5:15) pobieramy oficjalny Biuletyn KRS – listę numerów KRS spółek, które danego dnia miały wpis w rejestrze – i usuwamy z pamięci ich odpisy. Następne zapytanie o taką spółkę pobiera odpis na nowo.
Granice: z pamięci korzystamy tylko wtedy, gdy Biuletyn był sprawdzony w ciągu ostatnich 12 godzin, a odpis nie jest starszy niż 30 dni. Błędów i odpowiedzi „brak podmiotu” nie zapisujemy.
Dowód w raporcie: odpis z pamięci ma czas, adres zapytania i skrót SHA-256 oryginalnego pobrania z API KRS, a przy źródle widnieje adnotacja, np. „z pamięci podręcznej registerAPI: odpis pobrany z API KRS 16.10.2026 10:12; brak wpisów dla tego numeru KRS w Biuletynie KRS sprawdzonym do 16.10.2026 14:05”.
Przerwa techniczna KRS: gdy API KRS nie odpowiada, raport dostaje ostatni odpis z pamięci (nie starszy niż 30 dni) z ostrzeżeniem, że zmiany w rejestrze po dacie pobrania mogą nie być uwzględnione.
Świeży odpis na żądanie: dodaj do zapytania "odswiez": true – raport pomija pamięć i zawsze pobiera odpis z API KRS.

curl -X POST https://registerapi.goaml.pl/registers/report \
  -H "x-api-key: TWÓJ_KLUCZ" -H "Content-Type: application/json" \
  -d '{"krs": "0000028860", "odswiez": true}'

Rejestry firm w innych państwach UE

Raport z rejestrów obejmuje także podmioty z siedzibą w Czechach, we Francji, w Belgii i w Rumunii. Dane pochodzą z oficjalnych, publicznych interfejsów rejestru państwa siedziby, a dla Rumunii z danych otwartych rejestru handlowego ONRC publikowanych co miesiąc (raport podaje dzień stanu danych); raport zawiera nazwę, formę prawną, status, adres, kapitał, organy z datami urodzenia członków, a dla Czech także wspólników z udziałami, oraz dzień stanu danych.

kraj	identyfikator	Źródło
PL	pola nip albo krs	biała lista VAT, KRS, CRBR, CEIDG
CZ	IČO (8 cyfr)	ARES – rejestr podmiotów gospodarczych i rejestr handlowy (Obchodní rejstřík)
FR	SIREN (9 cyfr) albo SIRET (14 cyfr)	Registre national des entreprises (RNE) przez API INPI: pełny skład organów z datami urodzenia, kapitał, forma prawna; zapasowo API Recherche d'entreprises
BE	numer przedsiębiorstwa KBO (10 cyfr)	Banque-Carrefour des Entreprises / KBO – web service Public Search: firma, forma, status, adres, kapitał, aktualne funkcje (zarząd, biegli; bez dat urodzenia)
RO	CUI (2–10 cyfr)	Rejestr handlowy ONRC – dane otwarte data.gov.ro, aktualizacja miesięczna: firma, stan, reprezentanci z datami i miejscem urodzenia (bez wspólników)

curl -X POST https://registerapi.goaml.pl/registers/report \
  -H "x-api-key: TWÓJ_KLUCZ" -H "Content-Type: application/json" \
  -d '{"kraj": "CZ", "identyfikator": "45274649"}'

Odpowiedź zawiera dodatkowo pola kraj, identyfikator i podsumowanie (dane podmiotu i lista osoby). Cena jak za raport z rejestrów polskich.

Kraj rozpoznajemy także automatycznie: numer VAT UE z prefiksem (np. CZ45274649, FR40552081317, RO1590082, BE0417497106) podany w polu nip – w /registers/report i w /verify-company – kieruje zapytanie do rejestru państwa siedziby. Sam NIP (10 cyfr) albo NIP z prefiksem PL oznacza podmiot polski. Numery z innych państw UE zwracają czytelny błąd, dopóki ich rejestr nie zostanie dodany.

Beneficjenci rzeczywiści podmiotów z UE – BORIS

Od wyroku TSUE z 22.11.2022 (C-37/20 i C-601/20) rejestry beneficjentów rzeczywistych państw UE nie są publicznie dostępne, więc registerAPI nie pobiera ich automatycznie. Instytucja obowiązana może je sprawdzić sama przez europejski system łączenia rejestrów BORIS:

Otwórz portal e-Sprawiedliwość: BORIS – system integracji rejestrów beneficjentów rzeczywistych.
Wybierz państwo siedziby podmiotu i wyszukaj go po nazwie lub numerze rejestrowym (ten sam identyfikator, który podajesz w registerAPI).
Krajowy rejestr może wymagać zalogowania lub wykazania uzasadnionego interesu – jako instytucja obowiązana wskaż obowiązek stosowania środków bezpieczeństwa finansowego (art. 34 ustawy AML).
Zapisz wydruk lub potwierdzenie z rejestru w dokumentacji klienta, razem z raportem z registerAPI. Gdy dostęp nie jest możliwy, ustal beneficjentów na podstawie oświadczenia i dokumentów od klienta.

Załóż konto i przetestuj Zaloguj się