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