Dokumentacja MGBI API
  1. pl-crbr-wp-record
Dokumentacja MGBI API
  • MGBI API
    • Wprowadzenie
    • Autoryzacja
    • Pojęcia
    • Modele danych
      • pl-krs-wp-record
      • pl-krs-rdf-record
      • pl-krz-wp-record
      • pl-wpv-record
      • pl-crbr-wp-record
      • pl-msig-record
    • Endpointy dla modeli danych
      • pl-krs-wp-record
        • Get Record By Id
        • Get Records
        • Stream Records
        • Download File By Id
        • Get Limits
        • Get Projections
      • pl-krs-rdf-record
        • Get Record By Id
        • Get Records
        • Stream Records
        • Download File By Id
        • Get Limits
        • Get Projections
      • pl-krz-wp-record
        • Get Record By Id
        • Get Records
        • Stream Records
        • Get Limits
        • Get Projections
      • pl-wpv-record
        • Get Record By Id
        • Get Records
        • Stream Records
        • Get Limits
        • Get Projections
      • pl-crbr-wp-record
        • Get Record By Id
          GET
        • Get Records
          GET
        • Stream Records
          GET
        • Get Limits
          GET
        • Get Projections
          GET
      • pl-msig-record
        • Get Record By Id
        • Get Records
        • Stream Records
        • Download File By Id
        • Get Limits
        • Get Projections
    • Zlecanie odświeżenia danych
      • Ogólne informacje
      • Create Refresh
      • Get Refresh
  1. pl-crbr-wp-record

Get Records

GET
/v1/models/pl-crbr-wp-record/records
Pobiera rekordy z danymi z Wyszukiwarki Podmiotów Centralnego Rejestru Beneficjentów Rzeczywistych (CRBR) spełniające podane kryteria.
W przypadku sukcesu w odpowiedzi zwraca paginowaną listę rekordów posortowaną malejąco według daty i czasu wersji danych.
W przypadku braku rekordów spełniających podane kryteria zwraca pustą listę.
Poprawne wywołanie endpointu zwiększa liczniki:
api i api_search o 1
records i records_api_search o liczbę zwróconych rekordów
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.mgbi.pl/v1/models/pl-crbr-wp-record/records?limit=&offset=&page=&per_page=&last_update_datetime_from=&last_update_from_datetime=&last_update_datetime_to=&last_update_to_datetime=&identifiers.pl_krs=&identifiers.pl_nip=&version.from_datetime=&version.to_datetime=&version.latest=&projection=&content=&refresh_id=' \
--header 'Authorization;'
Response Response Example
200 - Success Example
{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": "677db9f81579bbb043f31c39",
            "content": {
                "raw_result": {
                    "id": "099c4970-2630-431f-b7c6-1b2d4758dcd2",
                    "dataZdarzenia": null,
                    "dataPoczatkuPrezentacji": "2020-07-09",
                    "dataKoncaPrezentacji": "2020-08-13",
                    "skorygowane": null,
                    "spolka": {
                        "nip": "5250000251",
                        "krs": "0000019193",
                        "pelnaNazwa": "POLSKIE KOLEJE PAŃSTWOWE SPÓŁKA AKCYJNA",
                        "formaOrganizacyjna": "116",
                        "formaOrganizacyjnaOpis": "Spółka akcyjna",
                        "postepowanie": null,
                        "adresSiedziby": {
                            "kodPocztowy": "02-305",
                            "wojewodztwo": "MAZOWIECKIE",
                            "wojewodztwoKod": null,
                            "gmina": null,
                            "gminaKod": null,
                            "powiat": null,
                            "powiatKod": null,
                            "miejscowosc": "WARSZAWA",
                            "miejscowoscKod": null,
                            "ulica": "ALEJE JEROZOLIMSKIE",
                            "brakUlicyWSlowniku": null,
                            "brakUlicWMiejscowosci": null,
                            "nrDomu": "142A",
                            "nrLokalu": null
                        },
                        "adresZagranicznySiedziby": null,
                        "rejestrZagranicznyTrust": null,
                        "listaInformacjiORozbieznosciach": null,
                        "idTech": "18eb2b69-f032-49da-a86a-d5b11e5e69c3"
                    },
                    "listaBeneficjentow": [
                        {
                            "pesel": "69110606559",
                            "dataUrodzenia": null,
                            "imiePierwsze": "JACEK",
                            "imieDrugieINastepne": "ROBERT",
                            "nazwisko": "SASIN",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "nazwaBeneficjentaGrupowego": null,
                            "informacjeOUprawnieniachTrust": null,
                            "informacjeOUdzialeLubUprawnieniach": [
                                {
                                    "charakterUdzialu": 3,
                                    "rodzajWlasnosci": null,
                                    "rodzajWlasnosciOpis": null,
                                    "jednostkaMiaryUdzialu": null,
                                    "jednostkaMiaryUdzialuOpis": null,
                                    "ilosc": null,
                                    "rodzajUprzywilejowania": null,
                                    "opisPrzywileju": null,
                                    "uprWlasPosrednie": null,
                                    "inneUprBO": {
                                        "rodzajInnychUprawnien": {
                                            "kod": "000",
                                            "opis": "inne stare – wartość wpisana w starej wersji formularza"
                                        },
                                        "opisInnychUprawnien": "CZŁONEK RADY MINISTRÓW - MINISTER AKTYWÓW PAŃSTWOWYCH, KTÓRY W IMIENIU SKARBU PAŃSTWA WYKONUJE PRAWA Z 100% AKCJI W OPARCIU O ART. 7 UST. 2 USTAWY Z DNIA 16.12.2016 R. O ZASADACH ZARZĄDZANIA MIENIEM PAŃSTWOWYM"
                                    },
                                    "idTech": "2de36ad9-4ab2-4cf2-b86d-28a1782c0fcf"
                                }
                            ],
                            "idTech": "1d65f6df-de3d-4494-b6ea-b2a2d0e6ae1a"
                        }
                    ],
                    "listaZglaszajacych": [
                        {
                            "pesel": "59060500313",
                            "dataUrodzenia": null,
                            "imiePierwsze": "MIROSŁAW",
                            "imieDrugieINastepne": "ANDRZEJ",
                            "nazwisko": "ANTONOWICZ",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "inneInformacje": null,
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "1173ad9b-cfdc-4e38-a66a-f3a37ed45d1d"
                        },
                        {
                            "pesel": "65080304293",
                            "dataUrodzenia": null,
                            "imiePierwsze": "ANDRZEJ",
                            "imieDrugieINastepne": "ANTONI",
                            "nazwisko": "OLSZEWSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "inneInformacje": null,
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "2a64a497-84ab-4e40-a270-77e9952a4808"
                        },
                        {
                            "pesel": "59080403540",
                            "dataUrodzenia": null,
                            "imiePierwsze": "MAŁGORZATA",
                            "imieDrugieINastepne": null,
                            "nazwisko": "ZIELIŃSKA",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "inneInformacje": null,
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "73894a2d-84e7-495f-9d18-62a7f9853ed9"
                        },
                        {
                            "pesel": "77010900778",
                            "dataUrodzenia": null,
                            "imiePierwsze": "KRZYSZTOF",
                            "imieDrugieINastepne": null,
                            "nazwisko": "GOLUBIEWSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "inneInformacje": null,
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "ed49e348-a913-4381-a66e-175a0fff9598"
                        },
                        {
                            "pesel": "57012601570",
                            "dataUrodzenia": null,
                            "imiePierwsze": "KRZYSZTOF",
                            "imieDrugieINastepne": "WACŁAW",
                            "nazwisko": "MAMIŃSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "inneInformacje": null,
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "0fd1b768-06b6-4896-b941-787fdb80ccb7"
                        }
                    ],
                    "oswiadczenie": null,
                    "korekta": false,
                    "podpisy": null,
                    "listaInformacjiORozbieznosciach": []
                }
            },
            "identifiers": {
                "pl_krs": "0000019193",
                "pl_nip": "5250000251"
            },
            "version": {
                "from_datetime": "2020-07-09T00:00:00+02:00",
                "to_datetime": "2020-07-10T00:00:00+02:00",
                "latest": false
            },
            "meta": {
                "first_update_datetime": "2025-01-07T23:34:01.119000",
                "last_update_datetime": "2025-01-07T23:34:01.119000"
            }
        }
    ]
}

Request

Query Params
limit
integer 
optional
Liczba zwracanych wyników
>= 1
offset
integer 
optional
Indeks rekordu, od którego mają być zwrócone kolejne rekordy
>= 0
page
integer 
optional
Numer strony wyników
>= 1
per_page
integer 
optional
Liczba rekordów na stronę
>= 1
last_update_datetime_from
string <date-time>
optional
Data i czas ostatniej aktualizacji od
last_update_from_datetime
string <date-time>
deprecated
Data i czas ostatniej aktualizacji od
last_update_datetime_to
string <date-time>
optional
Data i czas ostatniej aktualizacji do
last_update_to_datetime
string <date-time>
deprecated
Data i czas ostatniej aktualizacji do
identifiers.pl_krs
string 
optional
Numer KRS
Match pattern:
^\d{10}$
identifiers.pl_nip
string 
optional
Numer NIP
Match pattern:
^\d{10}$
version.from_datetime
string <date-time>
optional
Data i czas wersji danych od
version.to_datetime
string <date-time>
optional
Data i czas wersji danych do
version.latest
boolean 
optional
Informacja, czy zwrócona ma być tylko najnowsza wersja danych
projection
string 
optional
Nazwa projekcji
content
array[string]
optional
Lista zwracanych pól z modelu danych
refresh_id
string 
optional
Identyfikator zlecenia odświeżenia danych
Header Params
Authorization
string 
optional
Klucz autoryzacji
Example:
aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Responses

🟢200OK
application/json
Lista rekordów
Body
count
integer 
required
Liczba rekordów
pages
integer 
optional
Liczba stron
results
array[object (CrbrWpRecordModel_external) {5}] 
required
Lista rekordów
id
string 
required
Identyfikator rekordu
version
object 
required
Informacje o wersji rekordu
identifiers
object 
required
Identyfikatory podmiotu
content
object 
required
Treść odpowiedzi z wyszukiwarki
meta
object 
required
Metadane
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠422Parameter Error
🟠429429
Modified at 2025-07-18 17:08:55
Previous
Get Record By Id
Next
Stream Records
Built with