How do I retrieve the current list of a company’s board members from the National Court Register (KRS) via the API?

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 covers the API for the KRS entity search tool, which we provide as part of the following product:
👉 National Court Register API (KRS API) - Entity Search Tool

Below, we describe how you can use the API to retrieve the current list of board members for a specific entity based on its KRS number.

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 the data available in the KRS entity search engine accessible via the MGBI API in a data model with the identifier pl-krs-wp-record.

The API provides a Get Records endpoint for this model, which returns records containing the content of the current and full extracts from the National Court Register (KRS) for entities that meet the specified criteria.
👉 Documentation for the Get Records endpoint for the pl-krs-wp-record model

To retrieve data for a single entity from the National Court Register (KRS), you must provide its registration number—KRS, NIP, or REGON—in the Get Records endpoint.

Example of calling the Get Records endpoint using a KRS number:

GET /v1/models/pl-krs-wp-record/records?identifiers.pl_krs=[KRS number] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]

Step 3: Extract the board members' information from the responses

A successful call to the Get Records endpoint returns a list of records that meet the specified criteria.

In the example above, the endpoint should return a list of results containing a single record:

{
    "count": 1,
    "pages": 1,
    "results": [
        {
            "id": [identyfikator rekordu],
            "identifiers": [identyfikatory podmiotu i powiązanych osób],
            "content": [treść odpisu aktualnego i pełnego],
            "files": [pliki odpisów w formacie PDF],
            "relations": [relacje podmiotu z innymi podmiotami i osobami],
            "meta": [metadane rekordu]
        }
    ]
}

You can find the current list of the entity's board members in the field: content.current_excerpt.dane.dzial2.reprezentacja.sklad

Each item in the list displayed in this field contains information about an individual who holds a specific position within the entity’s governing body.

Sample content of the list item `content.current_excerpt.data.section2.representation.composition`:

{
    "nazwisko": {
        "nazwiskoICzlon": [pierwszy człon nazwiska],
        "nazwiskoIICzlon": [drugi człon nazwiska]
    },
    "imiona": {
        "imie": [imię]
    },
    "identyfikator": {
        "pesel": [numer PESEL]
    },
    "funkcjaWOrganie": [nazwa pełnionej funkcji],
    "czyZawieszona": [czy osoba została zawieszona w czynnościach]
}

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