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

Request body

Property	Type	Description
searchText	string	Search text: person name, EGN, or company EIK/BULSTAT.
ident	string	Person identifier: EGN, LNCH, or assumed EGN.
identType	int	Identifier type. Possible values: 1 – EGN; 2 – LNCH; 3 – assumed EGN; 4 – not found; 5 – ChFL; 6 – unknown.
rootClassifier.type	int	Root classifier type. Possible values: 1 – ZPKONPI; 2 – ZMIP; 3 – Position; 4 – Organization.
rootClassifier.id	int	Sub-classifier identifier.
yearTo	int	Upper year boundary for the search.
classifiers.categoryKPKONPI	array<int>	ZPKONPI classifier identifiers.
classifiers.categoryZMIP	array<int>	ZMIP classifier identifiers.
classifiers.position	array<int>	Position classifier identifiers.
classifiers.organization	array<int>	Organization classifier identifiers.
pageSize	int	Number of results per page. Default: 20.
page	int	Page number. Default: 1.
withAggs	bool	Whether classifier aggregations/filters are returned. Possible values: true, false. Default: true.
searchAfter	array<string>	Cursor used when the result set exceeds 1000 documents. Supply two values: the last document name and identifier.

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.categoryKPKONPI) 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.categoryKPKONPI) 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.organization) 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.organization) 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

Property	Type	Description
email	string	Email address.
data	string	Input rows in identifier;name format. Identifier is optional; name is required. Separate rows with \r\n.

Request body

Property	Type	Description
type	int	Report type. Possible values: 1 – quick report (fewer than 1000 rows, not saved to logs); 2 – daily report (saved to logs and delivered by email). Default: 1.
data	string	Input rows in identifier;name format. Identifier is optional; name is required. Separate rows with \r\n.