MGBI provides a comprehensive API for retrieving data from public registers and records, including the Central Register of Beneficial Owners (CRBR).
You can find a list of data sources available through this service at:
👉 Public Registers API
This guide covers the API for the CRBR entity search tool, which we provide as part of the following product:
👉 Central Register of Beneficial Owners API (CRBR API) - Entity Search Tool
Below, we describe how you can use the API to retrieve a list of an entity’s beneficial owners from the CRBR based on its tax identification number (NIP).
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:
👉 Central Register of Beneficial Owners API (CRBR API) - Entity Search
Step 2: Call the Create Refresh endpoint
We make the data available in the CRBR Entity Search Engine accessible via the MGBI API in a data model with the identifier pl-crbr-wp-record.
This model is synchronized on demand, which means that we do not have a complete copy of the data available in the source registry in our database.
To retrieve current data on a specific debtor from the model, you must first create a request to fetch it from the CRBR using the Create Refresh endpoint.
👉 Create Refresh endpoint documentation
Example of calling the Create Refresh endpoint with the tax ID number:
POST /v1/refresh HTTP/1.1
Host: api.mgbi.pl
Authorization: [klucz autoryzacji]
{
"query: {
"model": "pl-crbr-wp-record",
"identifiers.pl_nip": [numer NIP]
}
}
A successful call to the Create Refresh endpoint returns a dictionary containing the request ID in the id field.
Step 3: Call the Get Refresh endpoint
Requests to retrieve data from the source registry typically take a few to several seconds to complete after they are created by the Create Refresh endpoint.
To check the current status of the order, call the Get Refresh endpoint and include the order ID obtained in the previous step in the URL.
👉 Get Refresh endpoint documentation
Example of a Get Refresh endpoint call with the following request ID:
GET /v1/refresh/[order ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]
If the status field in the returned dictionary is set to " pending," the request is still being processed, and you should call the Get Refresh endpoint again in a few seconds.
If the status field is set to "success," this means that the request has been processed and the data regarding the specified debtor has already been retrieved from the source registry.
Step 4: Call the Get Records endpoint
The API for the pl-crbr-wp-record model provides a Get Records endpoint that returns records containing the full response content from the CRBR Entity Search Engine for the specified debtor.
👉 Documentation for the Get Records endpoint for the pl-crbr-wp-record model
To retrieve data from the source registry in a previously created request, call the Get Records endpoint and pass the request ID in the refresh_id parameter.
Example of calling the Get Records endpoint with a request ID:
GET /v1/models/pl-crbr-wp-record/records?refresh_id=[order ID] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]
Step 5: Review the list of beneficial owners provided in the response
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],
"version": [informacje o wersji rekordu],
"content": [treść odpowiedzi z wyszukiwarki],
"meta": [metadane rekordu]
}
]
}
The list of the entity's beneficial owners is available in the content.raw_result.listaBeneficjentow field.
Each entry in the list contains information about an individual beneficiary, such as their first and last name, countries of citizenship, and details regarding their ownership interest or other entitlements.
Sample content of the element:
{
"pesel": [numer PESEL],
"dataUrodzenia": [data urodzenia],
"imiePierwsze": [pierwsze imię],
"imieDrugieINastepne": [drugie imię],
"nazwisko": [nazwisko],
"obywatelstwo": [kraje obywatelstwa],
"panstwoZamieszkania": [państwo zamieszkania],
"nazwaBeneficjentaGrupowego": [nazwa beneficjenta grupowego],
"informacjeOUprawnieniachTrust": [informacje o uprawnieniach w truście],
"informacjeOUdzialeLubUprawnieniach": [informacje o udziale lub innych uprawnieniach],
"idTech": [wewnętrzny identyfikator beneficjenta]
}
Learn more:
👉 Data structure in the pl-crbr-wp-record model
👉 Endpoint documentation for the pl-crbr-wp-record model
