Rejestry publiczne API

MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z Centralnego Rejestru Umów Jednostek Sektora Finansów Publicznych (CRU JSFP).

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

👉 Rejestry Publiczne API

Ten poradnik dotyczy API dla Centralnego Rejestru Umów (CRU JSFP), który udostępniamy w ramach produktu:

👉 Centralny Rejestr Umów API (CRU API)

Poniżej opisaliśmy, w jaki sposób możesz pobrać przez API rekordy z informacjami o umowach ujawnionych w CRU, których stroną jest wskazany podmiot, 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:👉 Centralny Rejestr Umów API (CRU API)

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w CRU udostępniamy w MGBI API w modelu danych o identyfikatorze pl-cru-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy z informacjami o umowach z CRU, spełniające podane kryteria.

👉 Dokumentacja endpointu Get Records dla modelu pl-cru-record


Pobranie rekordów z listą umów zawartych przez dany podmiot wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON.

Wskazany podmiot może być dowolną stroną umowy. W ten sposób pobierzesz zarówno umowy zawarte przez jednostkę sektora finansów publicznych (JSFP), np. gminę lub urząd, jak i umowy, w których podmiot występuje jako jej kontrahent.


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

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


Jeśli znasz numer konkretnej umowy, możesz pobrać informacje o niej, podając w endpoincie Get Records jej numer w parametrze identifiers.pl_cru_contract_number.


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

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


Numery umów nie są unikalne – różne jednostki mogą nadawać umowom takie same numery (np. „1/2025”). Dlatego zapytanie o numer umowy może zwrócić kilka rekordów. Właściwą umowę rozpoznasz wtedy po jej stronach, opisanych w liście content.raw_result.stronyUmowy.

Krok 3: Odczytaj z odpowiedzi informacje o umowach zawartych przez podmiot

Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi listę umów ujawnionych w CRU, których stroną jest dany podmiot. Każda umowa to osobny rekord w liście results.

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory wszystkich stron umowy oraz numer umowy]",
            "content": "[informacje o umowie]",
            "meta": "[metadane rekordu]"
        }
    ]
}


Wszystkie dane o pojedynczej umowie ujawnionej w CRU możesz znaleźć w słowniku content.raw_result.


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

{
    "idUmowy": "[identyfikator umowy]",
    "podstawoweDane": {
        "statusUmowy": "[status umowy: Aktywna / Nieaktywna]",
        "numerUmowy": "[numer umowy]",
        "brakNumeruUmowy": "[czy umowa nie ma numeru]",
        "dataZawarciaUmowy": "[data zawarcia umowy]",
        "dataZakonczeniaUmowy": "[data zakończenia umowy]"
    },
    "okresObowiazywania": {
        "umowaNaCzasNieoznaczony": "[czy umowa na czas nieoznaczony]",
        "okres": "[okres obowiązywania umowy]"
    },
    "szczegolyUmowy": {
        "przedmiotUmowy": "[przedmiot umowy]",
        "niejawnoscPrzedmiotu": "[informacja o niejawności przedmiotu umowy]",
        "wartoscPrzedmiotu": "[wartość przedmiotu umowy]",
        "niejawnoscWartosciPrzedmiotu": "[informacja o niejawności wartości przedmiotu umowy]",
        "opisWartosciPrzedmiotu": "[opis wartości przedmiotu umowy]"
    },
    "stronyUmowy": [
        {
            "rodzaj": "[rodzaj strony umowy: JSFP / Przedsiębiorca / Osoba fizyczna]",
            "nazwa": "[nazwa strony umowy]",
            "nip": "[NIP strony umowy]",
            "regon": "[REGON strony umowy]",
            "imie": "[imię strony umowy]",
            "nazwisko": "[nazwisko strony umowy]",
            "kraj": "[kraj strony umowy]",
            "czyKonsorcjum": "[czy strona umowy jest konsorcjum]",
            "daneAdresowe": "[dane adresowe strony umowy]",
            "niejawnoscStrony": "[informacja o niejawności strony umowy]"
        }
    ],
    "finansowanaZeSrodkow": "[czy umowa jest finansowana ze środków]",
    "zmianyUmowy": [
        {
            "rodzajZmiany": "[rodzaj zmiany]",
            "dataZmiany": "[data zmiany]",
            "komentarz": "[komentarz]"
        }
    ],
    "dataPublikacji": "[data publikacji umowy]",
    "dataModyfikacji": "[data modyfikacji umowy]"
}


Informacje o wszystkich stronach umowy, zarówno o jednostce sektora finansów publicznych (JSFP), jak i o jej kontrahentach, znajdziesz w liście content.raw_result.stronyUmowy.

Pole rodzaj pozwala ustalić, czy dana strona to JSFP, przedsiębiorca czy osoba fizyczna.


Uzyskaj więcej informacji:

👉 Struktura danych w modelu pl-cru-record

👉 Dokumentacja endpointów dla modelu pl-cru-record

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

Skontaktuj się z nami
arrow_forward