How do I use the API to retrieve the content of KRS entries generated based on full copies?

MGBI provides a comprehensive API for retrieving data from public registers and records, including the National Court Register (KRS). You can find a list of data sources available through this service at:
👉Public Registers API

This guide coversthe API for entries in the National Court Register (KRS), which we provide as part of the following product:
👉National Court Register API (KRS API) - Entity Search

Below, we describe how you canuse the API to retrieve entries from the National Court Register (KRS) for a specific entity based on its registration number: KRS, NIP, or REGON.

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:
👉National Court Register API (KRS API) - Entity Search

Step 2: Call the Get Records endpoint

We make KRS registry entries available via the MGBI API in the data model with the identifierpl-krs-wp-entry.

The API provides aGet Records endpoint for this model, which returns a list of KRS entries generated based on the content of full transcripts from the KRS Entity Search for entities that meet the specified criteria.
👉Documentation for the Get Records endpoint for the pl-krs-wp-entry model

To retrieve a list of entries in the National Court Register (KRS) for a single entity, you must provide its registration number—KRS, NIP, or REGON—in the Get Records endpoint, along with additional parameters such as:

• entry.date_from - search starting from the date the entry was added to the registry
• entry.date_to - search up to the date the entry was added to the registry

In the example below, theGet Recordsendpoint was used to retrieve KRS entries from 2025 onward for an entity with the specified NIP number.

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

GET /v1/models/pl-krs-wp-entry/records?entry.date_from=2025-01-01&identifiers.pl_nip=[NIP number] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]

Step 3: Use the response to retrieve the list of KRS entries for the entity

A successful call to theGet Recordsendpoint returns a list of records that meet the specified criteria. In the example above, the endpoint should return a list of results containing one or more records:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory podmiotu]",
            "entry": "[informacje o wpisie]",
            "content": "[treść wpisu]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Each record in the list contains a set of information about a single entry in the National Court Register (KRS) for the specified entity.

The most important information about the entry is available in theentry dictionary.

Contents of the dictionary entry for a single KRS entry:

{
    "signature": "[sygnatura wpisu]",
    "date": "[data wprowadzenia wpisu do rejestru w formacie ISO 8601]",
    "number": "[numer wpisu]"
}

The full text of the entry is contained in thecontent dictionary fields.

Dictionary content for a single entry in the National Court Register (KRS):

{
    "xml": "[treść wpisu w formacie XML]",
    "html": "[treść wpisu w formacie HTML]"
}

Learn more:
👉Data structure in the pl-krs-wp-entry model
👉Endpoint documentation for the pl-krs-wp-entry model