Bihus.Info unites anti-corruption projects created by the NGOs TOM 14 and the White Collar Hundred.
Support the project

DECLARATIONS: OPEN API

The Declarations project provides access to all available JSON machine-readable data using a simple open API.

In the new version of the API, we made it possible for site users to access all declarations, including digitized paper declaration (filed from 2011 to 2015 inclusive), and new electronic declarations from NACP (filed from 2015), in a single, unified format.

To access JSON data, simply add the "format=opendata" address bar parameter to almost any page.

Currently, the following URLs are available through the open API:

Please note that you can obtain machine-readable information for any search query (including full-text search, filters, sorting, and Boolean operators in the query). Just put your desired site query in the advanced search form, then add &format=opendata to the link in the address bar of your browser.

You can also get information from the following pages using the API:

In cases where a page address parameter is available, the results use page numbering to reduce the amount of data transmitted.

Page numbering information is available using the "paginator" key in the dictionary with the "results" key. Example:

"paginator": {"per_page": 30, "count": 1139, "num_pages": 38}

This means that there are 1,139 declarations on this request, distributed over 38 pages of 30 declarations per page. Numbering begins with one.

If you do not specify the "page" parameter in this query, you will get the results for the first page.

For each declaration, a document consisting of five sections is returned:

  • guid — the document's unique string code
  • infocard — a short card of the document describing the declarant (full name, place of work, and position), type of declaration, etc.
  • raw_source — for old, paper declarations, it will have a full machine-readable declaration document in the old format. For new NACP declarations, it will include a link to a machine-readable copy of the declaration on the NACP's website
  • unified_source — for old declarations, it will have a declaration that has been converted from the old format to the new one, similar to the NACP's. For new NAPC declarations, it will include a complete new declaration document with small format adjustments that we make to unify them.
  • related_entities — мcontains information on the related natural and legal persons of the declarant, as well as documents. Natural persons include the declarant's family. Legal persons include those companies in which the declarant is a beneficiary (owned by, only the EDRPOU code), has a financial connection (related, only the EDRPOU code), as well as all the companies mentioned in the declaration (all, may yield both EDRPOU codes and names). Finally, linked documents contain references to existing corrected (or original) declarations of the current one.

You can also get only the sections you need by adding a section parameter to the address bar, for example::

http://declarations.com.ua/search?q=&format=opendata&section=infocard&section=related_entities

The guid section is always present in the answer

You can also see an example of a python application that uses the API to download and save all declarations from the website (requires the requests library):