Rejestry publiczne API

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:

👉 Rejestry Publiczne API

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łę:

  1. Odrzuć wpisy ze statusem WYKREŚLONY.
  2. Spośród pozostałych wpisów wybierz ten z najpóźniejszą datą rozpoczęcia działalności (dataRozpoczecia).
  3. 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:

👉 Struktura danych w modelu pl-ceidg-hd-record

👉 Dokumentacja endpointów dla modelu pl-ceidg-hd-record

Demo jest warte więcej niż tysiąc słów

Skontaktuj się z nami
arrow_forward