Get Records - Dokumentacja MGBI API

Pobiera rekordy z danymi z Wyszukiwarki Podmiotów Centralnego Rejestru Beneficjentów Rzeczywistych (CRBR) spełniające podane kryteria.

Endpoint wymaga przekazania identyfikatora zlecenia odświeżenia danych w parametrze refresh_id. Więcej informacji o tworzeniu takich zleceń znajdziesz w sekcji Zlecanie odświeżenia danych.

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

api_search_results o 1, jeśli zwrócono co najmniej jeden rekord

records i records_api_search o liczbę zwróconych rekordów

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Lista rekordów

application/json

Lista rekordów

Bodyapplication/json

Example

{
    "count": 0,
    "pages": 0,
    "results": [
        {
            "_id": "67769232d29f87342811bc07",
            "content": {
                "identifiers": {
                    "pl_krs": "0000019193",
                    "pl_nip": "5250000251"
                },
                "raw_result": {
                    "dataKoncaPrezentacji": "2020-08-13",
                    "dataPoczatkuPrezentacji": "2020-07-09",
                    "id": "846e3f14-e498-4b4f-8cb7-f3a5034f1197",
                    "korekta": false,
                    "listaBeneficjentow": [
                        {
                            "idTech": "f6fa30b3-6a86-42f9-a757-1a7752be8025",
                            "imieDrugieINastepne": "ROBERT",
                            "imiePierwsze": "JACEK",
                            "informacjeOUdzialeLubUprawnieniach": [
                                {
                                    "charakterUdzialu": 3,
                                    "idTech": "6e441a1d-298c-4df7-b3e4-8e66f5e16259",
                                    "inneUprBO": {
                                        "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",
                                        "rodzajInnychUprawnien": {
                                            "kod": "000",
                                            "opis": "inne stare – wartość wpisana w starej wersji formularza"
                                        }
                                    }
                                }
                            ],
                            "nazwisko": "SASIN",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "69110606559"
                        }
                    ],
                    "listaInformacjiORozbieznosciach": [],
                    "listaZglaszajacych": [
                        {
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "8375782b-8bac-4fac-8b46-9f3760686629",
                            "imieDrugieINastepne": "ANDRZEJ",
                            "imiePierwsze": "MIROSŁAW",
                            "nazwisko": "ANTONOWICZ",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "59060500313"
                        },
                        {
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "f44af4c7-7aef-4eeb-be67-c10a9ff0b803",
                            "imieDrugieINastepne": "ANTONI",
                            "imiePierwsze": "ANDRZEJ",
                            "nazwisko": "OLSZEWSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "65080304293"
                        },
                        {
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "261ad14b-5fca-49b7-9e5e-bb6947962b92",
                            "imiePierwsze": "MAŁGORZATA",
                            "nazwisko": "ZIELIŃSKA",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "59080403540"
                        },
                        {
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "dbdcb726-e664-4ad6-9f3c-2ce17596e233",
                            "imiePierwsze": "KRZYSZTOF",
                            "nazwisko": "GOLUBIEWSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "77010900778"
                        },
                        {
                            "funkcjeZglaszajacego": [
                                {
                                    "kod": "101",
                                    "opis": "reprezentant"
                                }
                            ],
                            "idTech": "809d4df2-8793-4223-b496-8b7a3d52f007",
                            "imieDrugieINastepne": "WACŁAW",
                            "imiePierwsze": "KRZYSZTOF",
                            "nazwisko": "MAMIŃSKI",
                            "obywatelstwo": [
                                {
                                    "kodKraju": "PL",
                                    "nazwa": "POLSKA"
                                }
                            ],
                            "panstwoZamieszkania": {
                                "kodKraju": "PL",
                                "nazwa": "POLSKA"
                            },
                            "pesel": "57012601570"
                        }
                    ],
                    "spolka": {
                        "adresSiedziby": {
                            "kodPocztowy": "02-305",
                            "miejscowosc": "WARSZAWA",
                            "nrDomu": "142A",
                            "ulica": "ALEJE JEROZOLIMSKIE",
                            "wojewodztwo": "MAZOWIECKIE"
                        },
                        "formaOrganizacyjna": "116",
                        "formaOrganizacyjnaOpis": "Spółka akcyjna",
                        "idTech": "745138b3-b20e-4099-bf08-cb6cd82ef493",
                        "krs": "0000019193",
                        "nip": "5250000251",
                        "pelnaNazwa": "POLSKIE KOLEJE PAŃSTWOWE SPÓŁKA AKCYJNA"
                    }
                },
                "version": {
                    "from_datetime": "2020-07-09T00:00:00.000",
                    "latest": true,
                    "to_datetime": "2020-08-13T00:00:00.000"
                }
            },
            "meta": {
                "first_update_datetime": "2025-01-02T13:18:38.371000",
                "last_update_datetime": "2025-01-02T13:18:38.371000"
            }
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠429Too Many Requests