How do I retrieve individual CIT taxpayer data for a specific year via the API?

MGBI provides a comprehensive API for retrieving data from public registers and records, including information published by the Ministry of Finance. You can find a list of data sources available through this service at:
👉Public Registers API

This guide coversthe API for individual CIT taxpayer data, which we provide as part of the following product:
👉Individual CIT Taxpayer Data API

Below, we describe how you can use the API to search for records containing individual CIT taxpayer data based on registration numbers for a given calendar year.

Step 1: Obtain an API authorization key

To obtain the authorization key required to call endpoints available in the MGBI API, please contact us using the contact form on the product page:
👉Individual CIT taxpayer data API

Step 2: Call the Get Records endpoint

We make the data available in the CIT registry accessible via the MGBI API in the data model with the identifierpl-idpcit-record.

The API provides aGet Records endpoint for this model, which returns records containing individual CIT taxpayer data for entities that meet the specified criteria.
👉Documentation for the Get Records endpoint for the pl-idpcit-record model

To retrieve data for a single CIT taxpayer, you must provide their registration number—KRS, NIP, or REGON—in theGet Recordsendpoint. Optionally, you can specify the tax year using the list.fiscal_year parameter.

In the example below, theGet Recordsendpoint was used to retrieve the CIT taxpayer's data for 2025 for the specified NIP number.

Example of calling the Get Records endpoint with a tax ID number for the year 2025:

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

Step 3: Extract the taxpayer’s specific information from the response

A successful call to theGet Recordsendpoint returns a list of records that meet the specified criteria.

In the previous example, the endpoint should return a list of results containing one or more records:

{
    "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]"
        }
    ]
}

Each record in the list contains a set of individual data for a single CIT taxpayer.

Information about the list from which the entry originates is available in thelist dictionary.

Contents of the list dictionary:

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

You can find all individual data for a single tax year for the specified CIT taxpayer in thecontent.standarized_fields dictionary.

Contents of the content.standarized_fields dictionary:

{
    "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]"
}

Learn more:
👉Data structure in the pl-idpcit-record model
👉Endpoint documentation for the pl-idpcit-record model