Post Stream Records - Dokumentacja MGBI API

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

W przypadku sukcesu w odpowiedzi zwraca listę rekordów w postaci strumienia 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

Query Params

Header Params

Body Params application/jsonRequired

Example

{
    "meta.last_update_datetime_from": "2019-08-24T14:15:22.123Z",
    "meta.last_update_datetime_to": "2019-08-24T14:15:22.123Z",
    "identifiers.pl_nip": "string",
    "identifiers.pl_regon": "string",
    "basic.status": {},
    "projection": "string",
    "content": [
        "string"
    ]
}

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

[
    {
        "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