Get Records - Dokumentacja MGBI API

Pobiera rekordy z danymi z Hurtowni Danych Centralnej Ewidencji i Informacji o Działalności Gospodarczej (CEIDG) spełniające podane kryteria.

W przypadku sukcesu w odpowiedzi zwraca paginowaną listę rekordów.

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

🟢200Successful Response

application/json

Lista rekordów

Bodyapplication/json

Example

{
    "count": 0,
    "pages": 0,
    "results": [
        {
            "basic": {
                "status": "active"
            },
            "content": {
                "raw_result": {
                    "adresDzialalnosci": {
                        "budynek": "1",
                        "gmina": "Białystok",
                        "kod": "15-333",
                        "kraj": "PL",
                        "miasto": "Białystok",
                        "powiat": "Białystok",
                        "simc": "0922410",
                        "terc": "2061011",
                        "ulic": "26305",
                        "ulica": "ul. Zwierzyniecka",
                        "wojewodztwo": "PODLASKIE"
                    },
                    "adresKorespondencyjny": {
                        "budynek": "1",
                        "gmina": "Białystok",
                        "kod": "15-333",
                        "kraj": "PL",
                        "miasto": "Białystok",
                        "powiat": "Białystok",
                        "simc": "0922410",
                        "terc": "2061011",
                        "ulic": "26305",
                        "ulica": "ul. Zwierzyniecka",
                        "wojewodztwo": "PODLASKIE"
                    },
                    "dataRozpoczecia": "2014-07-28",
                    "id": "31F87519-9395-4FCF-8E19-6D5C0522FA7A",
                    "link": "https://test-dane.biznes.gov.pl/api/ceidg/v3/firma/31F87519-9395-4FCF-8E19-6D5C0522FA7A",
                    "nazwa": "Adam IntegracjaMGMF - Zmiana",
                    "numerStatusu": 9,
                    "obywatelstwa": [
                        {
                            "kraj": "Polska",
                            "symbol": "PL"
                        }
                    ],
                    "pkd": [
                        {
                            "kod": "3030Z",
                            "nazwa": "Nazwa kodu PKD 3030Z"
                        },
                        {
                            "kod": "3030Z",
                            "nazwa": "Nazwa kodu PKD 3030Z"
                        },
                        {
                            "kod": "3030Z",
                            "nazwa": "Nazwa kodu PKD 3030Z"
                        },
                        {
                            "kod": "3030Z",
                            "nazwa": "Nazwa kodu PKD 3030Z"
                        }
                    ],
                    "pkdGlowny": {
                        "kod": "3030Z",
                        "nazwa": "Nazwa kodu PKD 3030Z"
                    },
                    "rokPkd": "2007",
                    "spolki": [
                        {
                            "nip": "8567773578",
                            "regon": "113110043"
                        }
                    ],
                    "status": "AKTYWNY",
                    "wlasciciel": {
                        "imie": "Adam",
                        "nazwisko": "IntegracjaMGMF - Zmiana",
                        "nip": "2367852376",
                        "regon": "29883786011481"
                    },
                    "wspolnoscMajatkowa": 0
                }
            },
            "id": "69944d67becc0528b426e6ee",
            "identifiers": {
                "pl_nip": "2367852376",
                "pl_regon": "29883786011481"
            },
            "meta": {
                "first_update_datetime": "2026-02-17T11:13:41.491Z",
                "last_update_datetime": "2026-02-17T12:04:14.477Z"
            }
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠429Too Many Requests