Jak pobrać przez API idywidualne dane podatnika CIT za dany rok?

MGBI dostarcza kompleksowe API do pobierania danych z rejestrów i ewidencji publicznych, w tym z informacji publikowanych przez Ministerstwo Finansów. Listę źródeł danych dostępnych w tej usłudze znajdziesz na stronie:
👉 Rejestry Publiczne API

Ten poradnik dotyczy API dla indywidualnych danych podatników CIT, który udostępniamy w ramach produktu:
👉 Indywidualne dane podatników CIT API

Poniżej opisaliśmy, w jaki sposób możesz wyszukać przez API rekordy z indywidualnymi danymi podatników CIT na podstawie numerów rejestrowych za dany rok kalendarzowy.

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:
👉 Indywidualne dane podatników CIT API

Krok 2: Wywołaj endpoint Get Records

Dane dostępne w rejestrze CIT udostępniamy w MGBI API w modelu danych o identyfikatorze pl-idpcit-record.

API udostępnia dla tego modelu endpoint Get Records, który zwraca rekordy zawierające indywidualne dane podatników CIT, dla podmiotów spełniających podane kryteria.
👉 Dokumentacja endpointu Get Records dla modelu pl-idpcit-record

Pobranie danych pojedynczego podatnika CIT wymaga podania w endpoincie Get Records jego numeru rejestrowego: KRS, NIP lub REGON. Opcjonalnie możliwe jest wskazanie roku podatkowego za pomocą parametru list.fiscal_year.

W przykładzie poniżej endpoint Get Records został użyty do odnalezienia danych podatnika CIT za 2025 rok dla wskazanego numeru NIP.

Przykład wywołania endpointu Get Records z numerem NIP za rok 2025:

GET /v1/models/pl-idpcit-record/records?identifiers.pl_nip=[numer NIP]&list.fiscal_year=2025 HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]

Krok 3: Odczytaj z odpowiedzi indywidualne dane podatnika CIT

Prawidłowe wywołanie endpointu Get Records zwraca w odpowiedzi listę rekordów spełniających podane kryteria.

We wcześniejszym przykładzie endpoint powinien zwrócić listę wyników zawierającą jeden lub więcej rekordów:

{
    "count": "[liczba wyników]",
    "pages": "[liczba stron wyników]",
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikator podmiotu]",
            "content": "[lista zwracanych pól z modelu]",
            "list": "[lista, z której pochodzi wpis]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Każdy rekord z listy zawiera zestaw indywidualnych danych dla pojedynczego podatnika CIT.

Dane o liście, z której pochodzi wpis, dostępne są w słowniku list.

Zawartość słownika list:

{
    "fiscal_year": "[rok podatkowy]",
    "entity_type": "[rodzaj podmiotu]",
    "version_date": "[stan danych na dzień]"
}

Wszystkie indywidualne dane za pojedynczy rok podatkowy dla wskazanego podatnika CIT możesz znaleźć w słowniku content.standarized_fields.

Zawartość słownika content.standarized_fields:

{
    "h_on": "[liczba porządkowa]",
    "h_tn": "[nazwa podatnika]",
    "h_vm": "[numer NIP]",
    "h_tyf": "[za rok podatkowy od]",
    "h_tyt": "[za rok podatkowy do]",
    "r_tr": "[suma przychodów]",
    "r_tr_fcg": "[suma przychodów, w tym z zysków kapitałowych]",
    "r_tr_fosor": "[suma przychodów, w tym z innych źródeł przychodu]",
    "r_tr_fqipr": "[suma przychodów, w tym z kwalifikowanych praw własności intelektualnej]",
    "tde_ttde": "[suma kosztów uzyskania przychodów]",
    "tde_ttde_fcg": "[suma kosztów uzyskania przychodów, w tym z zysków kapitałowych]",
    "tde_ttde_fosor": "[suma kosztów uzyskania przychodów, w tym z innych źródeł przychodu]",
    "tde_ttde_fqipr": "[suma kosztów uzyskania przychodów, w tym z kwalifikowanych praw własności intelektualnej]",
    "p_tp": "[suma dochodów]",
    "p_tp_fcg": "[suma dochodów, w tym z zysków kapitałowych]",
    "p_tp_fosor": "[suma dochodów, w tym z innych źródeł przychodu]",
    "p_tp_fqipr": "[suma dochodów, w tym z kwalifikowanych praw własności intelektualnej]",
    "l_tl": "[suma strat]",
    "l_tl_fcg": "[suma strat, w tym z zysków kapitałowych]",
    "l_tl_fosor": "[suma strat, w tym z innych źródeł przychodu]",
    "l_tl_fqipr": "[suma strat, w tym z kwalifikowanych praw własności intelektualnej]",
    "tb": "[podstawa opodatkowania]",
    "tb_fqipr": "[podstawa opodatkowania, w tym z kwalifikowanych praw własności intelektualnej]",
    "td": "[podatek należny, po uwzględnieniu podatku o którym mowa w art. 24b ustawy CIT]",
    "td_fqipr": "[podatek należny, po uwzględnieniu podatku o którym mowa w art. 24b ustawy CIT, w tym z kwalifikowanych praw własności intelektualnej]",
    "aloreeitcg": "[informacja, czy w załączniku do zeznania wskazano, że przynajmniej jedna ze spółek wchodzących w skład PGK jest spółką nieruchomościową, o której mowa w art. 4a pkt 35 ustawy]"
}

Uzyskaj więcej informacji:
👉 Struktura danych w modelu pl-idpcit-record
👉 Dokumentacja endpointów dla modelu pl-idpcit-record