MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Centralnej Ewidencji i Informacji o Działalności Gospodarczej (CEIDG).
Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
Ten poradnik dotyczy API dla Centralnej Ewidencji i Informacji o Działalności Gospodarczej (CEIDG), które udostępniamy w ramach produktu:
👉 Centralna Ewidencja i Informacja o Działalności Gospodarczej API (CEIDG API)
Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API rekord z aktualną treścią wpisu do CEIDG dla wskazanego przedsiębiorcy, na podstawie jego numerów rejestrowych.
Krok 1: Uzyskaj klucz autoryzacji w API
Aby zdobyć klucz autoryzacji wymagany przy wywoływaniu endpointów dostępnych w MGBI API, skontaktuj się z nami przy użyciu formularza kontaktowego na stronie produktu:👉 Centralna Ewidencja i Informacja o Działalności Gospodarczej API (CEIDG API)
Krok 2: Wywołaj endpoint Get Records
Dane dostępne w CEIDG udostępniamy w MGBI API w modelu danych o identyfikatorze pl-ceidg-hd-record.
API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy z treścią wpisów do CEIDG, spełniające podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-ceidg-hd-record
Pobranie rekordu z treścią wpisu do CEIDG dla danego przedsiębiorcy wymaga podania w endpoincie Get Records jego numeru rejestrowego: NIP lub REGON.
Przykład wywołania endpointu Get Records z numerem NIP:
GET /v1/models/pl-ceidg-hd-record/records?identifiers.pl_nip=[numer NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Możesz też wyszukać wpisy przedsiębiorców powiązanych ze wskazanym podmiotem, np. wspólników spółki cywilnej. Wystarczy, że podasz numer NIP, REGON lub KRS podmiotu powiązanego w parametrze relations.identifiers.pl_nip, relations.identifiers.pl_regon lub relations.identifiers.pl_krs.
Przykład wywołania endpointu Get Records z numerem NIP spółki cywilnej:
GET /v1/models/pl-ceidg-hd-record/records?relations.identifiers.pl_nip=[numer NIP spółki cywilnej] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
Krok 3: Odczytaj z odpowiedzi treść wpisu do CEIDG
Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi rekordy z treścią wpisów do CEIDG dla danego przedsiębiorcy. Każdy wpis to osobny rekord w liście results.
{
"count": 1,
"pages": 1,
"results": [
{
"id": "[identyfikator rekordu]",
"identifiers": "[identyfikatory przedsiębiorcy]",
"content": "[treść wpisu do CEIDG]",
"relations": "[identyfikatory podmiotów powiązanych]",
"meta": "[metadane rekordu]"
}
]
}
Wszystkie dane z wpisu do CEIDG dla wskazanego przedsiębiorcy możesz znaleźć w słowniku content.raw_result.
Przykładowa zawartość słownika content.raw_result:
{
"id": "[identyfikator wpisu w CEIDG]",
"nazwa": "[pełna nazwa firmy przedsiębiorcy]",
"status": "[status działalności, np. AKTYWNY / ZAWIESZONY / WYKREŚLONY]",
"dataRozpoczecia": "[data rozpoczęcia działalności]",
"dataZawieszenia": "[data zawieszenia działalności]",
"dataWznowienia": "[data wznowienia działalności]",
"dataZakonczenia": "[data zakończenia działalności]",
"dataWykreslenia": "[data wykreślenia z rejestru]",
"wlasciciel": {
"imie": "[imię przedsiębiorcy]",
"nazwisko": "[nazwisko przedsiębiorcy]",
"nip": "[NIP przedsiębiorcy]",
"regon": "[REGON przedsiębiorcy]"
},
"adresDzialalnosci": "[adres działalności]",
"adresKorespondencyjny": "[adres korespondencyjny]",
"adresyDzialalnosciDodatkowe": "[dodatkowe adresy działalności]",
"pkdGlowny": {
"kod": "[kod przeważającej działalności PKD]",
"nazwa": "[nazwa przeważającej działalności PKD]"
},
"pkd": "[lista kodów PKD wykonywanej działalności]",
"spolki": [
{
"nip": "[NIP spółki cywilnej]",
"regon": "[REGON spółki cywilnej]",
"dataZawieszenia": "[data zawieszenia działalności w spółce]"
}
],
"telefon": "[numer telefonu]",
"email": "[adres e-mail]",
"www": "[adres strony internetowej]",
"adresDoreczenElektronicznych": "[adres do doręczeń elektronicznych]",
"wspolnoscMajatkowa": "[informacja o małżeńskiej wspólności majątkowej]",
"zarzadcaSukcesyjny": "[dane zarządcy sukcesyjnego]",
"upadlosci": "[informacje dotyczące upadłości]",
"zakazy": "[lista zakazów]",
"uprawnienia": "[lista uprawnień]",
"ograniczenia": "[lista ograniczeń]",
"kwalifikacjeZawodowe": "[lista kwalifikacji zawodowych]",
"link": "[adres wpisu w CEIDG]"
}
Aktualny status działalności przedsiębiorcy znajdziesz w polu status.
Jak wybrać aktualny wpis, gdy odpowiedź zawiera kilka rekordów?
Jeden przedsiębiorca może mieć w CEIDG więcej niż jeden wpis. Każdy wpis ma własny identyfikator (content.raw_result.id), a numer NIP należy do przedsiębiorcy, a nie do wpisu.
Dlatego zapytanie o jeden NIP może zwrócić kilka rekordów – np. gdy przedsiębiorca zakończył wcześniejszą działalność i założył nową, ale też gdy w CEIDG ujawniono kilka niewykreślonych wpisów jednocześnie.
Kolejność rekordów w odpowiedzi nie zależy od ich statusu.
Rejestr nie wskazuje wprost, który wpis jest aktualny. Aby go wybrać, zalecamy następującą regułę:
- Odrzuć wpisy ze statusem WYKREŚLONY.
- Spośród pozostałych wpisów wybierz ten z najpóźniejszą datą rozpoczęcia działalności (dataRozpoczecia).
- Jeśli wszystkie wpisy są wykreślone, ostatnim wpisem jest ten z najpóźniejszą datą wykreślenia (dataWykreslenia) lub datą rozpoczęcia działalności (dataRozpoczecia).
Jeśli po odrzuceniu wpisów wykreślonych nadal zostaje więcej niż jeden wpis, oznacza to niejednoznaczność w danych źródłowych. W takim przypadku szczegóły wpisów możesz sprawdzić bezpośrednio w CEIDG, pod adresem z pola content.raw_result.link.
Pamiętaj, że pola w słowniku meta opisują aktualizację rekordu w MGBI API, a nie zmiany wpisu w CEIDG – nie służą więc do wyboru aktualnego wpisu.
Uzyskaj więcej informacji: