Лицата на властта API

Request body

Parameters	Description
searchText	Search by name, EGN or EIK/Bulstat
ident	Search identifier (EGN, LNCH, Assumed EGN)
identType	Identifier type (1 - EGN, 2 - LNCH and 3 - Assumed EGN).
rootClassifier.type	Classifiers (1 - ZPKONPI, 2 - ZMIP, 3 - Position and 4 - Organization).
rootClassifier.id	Sub-classifier
yearTo	Search year
classifiers.1	ZPKONPI classifier
classifiers.2	ZMIP classifier
classifiers.3	Position classifier
classifiers.4	Organization classifier
pageSize	Number of results per page (default - 20)
page	Page number (default - 1)
withAggs	Return results with filters. The value can be true or false (default - true)
searchAfter	If count of results are more than 1000, then to go to the next page you have to put value

Search by name

When you search by EGN, you have to send field "ident" with searching EGN.

Optional parameters are: "identType" (1 - EGN, 2 - LNCH or 3 - Assumed EGN), "yearTo", "classifiers" (1 - ZPKONPI, 2 - ZMIP, 3 - Position and 4 - Organization), "pageSize", "page" and "withAggs".

Example 1.1:

In the example below, we search "6510243709".

Example 1.2:

In the example below, we search assumed EGN (identType = 3) to year 2020.

Example 1.3:

In the example below, we search EGN (identType = 1) to year 2020. Page size is 20 per page and result return classifiers (withAggs = true). We search only in ZPKONPI category (classifiers.1) and sub-category (1 and 2).

Search by name or EIK/Bulstat

When you search by EGN, you have to send field "searchText" with searching name or EIK/Bulstat.

Optional parameters are: "yearTo", "classifiers" (1 - ZPKONPI, 2 - ZMIP, 3 - Position and 4 - Organization), "pageSize", "page" and "withAggs".

Example 2.1:

In the example below, we search "Иван".

Example 2.2:

In the example below, we search "Иван" to year 2020.

Example 2.3:

In the example below, we search "Иван" to year 2020. Page size is 20 per page and result return classifiers (withAggs = true).We search only in ZPKONPI category (classifiers.1) and sub-category (1 and 2).

Search by classifiers

When you search by classifiers, you have to send field "rootClassifier" and "yearTo".

Optional parameters are: "classifiers" "classifiers" (1 - ZPKONPI, 2 - ZMIP, 3 - Position and 4 - Organization), "pageSize", "page" and "withAggs".

Example 3.1:

In the example below, we search by classifier "ЗПКОНПИ" (type = 1) and sub-category "Президент и вицепрезидент" to year 2020.

Example 3.2:

In the example below, we search by classifier "ЗПКОНПИ" (type = 1) and sub-category "Народни представители" to year 2021.г. Page size is 20 per page and result return classifiers (withAggs = true).We search only in Organization category (classifiers.4) and sub-category (1 and 2).

Example 3.3:

In the example below, we search by classifier "ЗМИП" (type = 2) in all sub-categories to year 2024. Page size is 20 per page and result return classifiers (withAggs = true).We search only in Organization category (classifiers.4) and sub-category (1 and 2).

WARNING! If you set fields "ident", "searchText" and "rootClassifier", the result will take into account only the "ident" field.

Example 4.1:

WARNING! If you set fields "searchText" and "rootClassifier", the result will take into account only the "searchText" field.

Example 4.2:

WARNING! If you want to go to next page, you have to send request with different page.

Example 4.3:

WARNING! If the result returns more than 1000 documents, if you want to go to next page, you have to add field "searchAfter". "searchAfter" is array from 2 elements. First one element is the "name" and the second one element is the field "identifier" of the last document.

Example 4.4:

Request body

Parameters	Description
email	Email
data	Every row have to be two parts - identifier and name. Identifier is optional, but the name is required. They have to be separated with semicolon. Rows have to be separated with new line (\r\n).

Request body

Parameters	Description
type	Report type, by default is 1. 1 - Quick report. The data have to be less than 1000 rows and the result does not save in the logs. 2 - Daily report. The date does not have limit. The result saves in the logs. Every day at 9 o'clock, you will receive email with result.
data	Every row have to be two parts - identifier and name. Identifier is optional, but the name is required. They have to be separated with semicolon. Rows have to be separated with new line (\r\n).