Rejestry publiczne API

MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Krajowego Rejestru Elektronicznego Przedsiębiorców Transportu Drogowego (KREPTD).

Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API

Ten poradnik dotyczy API dla Krajowego Rejestru Elektronicznego Przedsiębiorców Transportu Drogowego (KREPTD), który udostępniamy w ramach produktu:
👉 Krajowy Rejestr Elektroniczny Przedsiębiorców Transportu Drogowego API (KREPTD API)

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API rekord z aktualną treścią wpisu do KREPTD dla wskazanego przedsiębiorcy, na podstawie jego numerów rejestrowych lub numeru referencyjnego KREPTD.

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:
👉 Krajowy Rejestr Elektroniczny Przedsiębiorców Transportu Drogowego API (KREPTD API)

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w KREPTD udostępniamy w MGBI API w modelu danych o identyfikatorze pl-kreptd-api-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy z treścią wpisów do KREPTD, spełniające podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-kreptd-api-record


Pobranie rekordu z treścią wpisu do KREPTD dla danego przedsiębiorcy wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON.


Przykład wywołania endpointu Get Records z numerem NIP:

GET /v1/models/pl-kreptd-api-record/records?identifiers.pl_nip=[numer NIP] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Jeśli znasz numer referencyjny przedsiębiorcy w systemie KREPTD (w formacie P/RRRR/NNNNNNNN), możesz go podać w parametrze identifiers.pl_kreptd_reference_number.


Przykład wywołania endpointu Get Records z numerem referencyjnym KREPTD:

GET /v1/models/pl-kreptd-api-record/records?identifiers.pl_kreptd_reference_number=[numer referencyjny KREPTD] HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Krok 3: Odczytaj z odpowiedzi treść wpisu do KREPTD

Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi aktualną treść wpisu do KREPTD dla danego przedsiębiorcy.

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory podmiotu oraz numer referencyjny KREPTD]",
            "content": "[treść wpisu do KREPTD]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Wszystkie dane z wpisu do KREPTD dla wskazanego podmiotu możesz znaleźć w słowniku content.extracted_fields.

Przykładowa zawartość słownika content.extracted_fields:

{
    "NumerReferencyjny": "[numer referencyjny przedsiębiorcy w KREPTD]",
    "FirmaNazwa": "[nazwa przedsiębiorcy]",
    "NIP": "[NIP przedsiębiorcy]",
    "FormaPrawna": "[forma prawna przedsiębiorcy]",
    "Adres": "[adres przedsiębiorcy]",
    "ListaZarzadzajacyTransportemDaneWyszukane": {
        "ZarzadzajacyTransportemDaneWyszukane": [
            {
                "Imiona": "[imię lub imiona osoby zarządzającej transportem]",
                "Nazwisko": "[nazwisko osoby zarządzającej transportem]",
                "NumerCertyfikatu": "[numer certyfikatu kompetencji zawodowych]",
                "RodzajCertyfikatu": "[rodzaj certyfikatu kompetencji zawodowych]",
                "DataWydaniaCertyfikatu": "[data wydania certyfikatu]",
                "KrajWydajacyCertyfikat": "[kod kraju, który wydał certyfikat]"
            }
        ]
    },
    "ListaZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp": {
        "ZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp": [
            {
                "Zakres": "[zakres zezwolenia: Osoby / Rzeczy]",
                "Numer": "[numer zezwolenia]",
                "StatusZezwolenia": "[status zezwolenia: Ważne / Ważność wygasła]",
                "OrganWydajacy": "[organ, który wydał zezwolenie]",
                "DataWydania": "[data wydania zezwolenia]",
                "LiczbaPojazdow": "[liczba pojazdów objętych zezwoleniem]"
            }
        ]
    },
    "ListaLicencjaWspolnotowaTyp": {
        "LicencjaWspolnotowaTyp": [
            {
                "Zakres": "[zakres licencji wspólnotowej]",
                "Numer": "[numer licencji wspólnotowej]",
                "StatusLicencji": "[status licencji wspólnotowej]",
                "PoczatekWaznosci": "[data początku ważności licencji]",
                "KoniecWaznosci": "[data końca ważności licencji]",
                "LiczbaPojazdow": "[liczba pojazdów objętych licencją]"
            }
        ]
    },
    "ListaWypisowZLicencjiTyp": "[wypisy z licencji wspólnotowych]",
    "ListaWypisowZzezwoleniaTyp": "[wypisy z zezwoleń]",
    "ListaPrzedstawicieliPrawnychTyp": {
        "PrzedstawicielPrawny": [
            {
                "Imiona": "[imię lub imiona przedstawiciela prawnego]",
                "Nazwisko": "[nazwisko przedstawiciela prawnego]"
            }
        ]
    }
}

Informacje o uprawnieniach przedsiębiorcy znajdziesz w listach zezwoleń na wykonywanie zawodu przewoźnika drogowego (ListaZezwolenieNaWykonywanieZawoduPrzewoznikaDrogowegoTyp) i licencji wspólnotowych (ListaLicencjaWspolnotowaTyp).


Aktualny status każdego dokumentu podają pola StatusZezwolenia i StatusLicencji. W przypadku cofnięcia, zawieszenia lub wygaśnięcia uprawnienia w rekordzie znajdziesz również odpowiednie daty oraz powód zawieszenia lub wycofania.


Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-kreptd-api-record
👉 Dokumentacja endpointów dla modelu pl-kreptd-api-record

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

Skontaktuj się z nami
arrow_forward