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 →API w chmurze
Zapytania REST/JSON na adres https://registerapi.goaml.pl z kluczem w nagłówku x-api-key. Klucz tworzysz w portalu (Klucze API), zapytania są rozliczane z salda konta.
curl -X POST https://registerapi.goaml.pl/sanctions/check \
-H "x-api-key: TWOJ_KLUCZ" -H "Content-Type: application/json" \
-d '{"typ": "osoba", "imie": "Jan", "nazwisko": "Kowalski", "data_urodzenia": "1970-01-31"}'Odpowiedź: wynik (hit, possible albo clear), trafienia z pozycją z listy, oceną i powodem dopasowania oraz listy ze stanem aktualizacji każdej listy.
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.