listAnnualReport(authorizedRequest $request)

List annual reports available to buy in registry.

Request parameters

  • token - access token (required)
  • country - country code, currently only EST is supported (optional, default EST)
  • reg_code - registration number of company (optional, default 10117826 Bisnode)

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
	<SOAP-ENV:listAnnualReport>
	  <item>
		<token>0c725874e737c8195de547f67692d8b976726561</token>
		<country>EST</country>
		<reg_code>10117826</reg_code>
	  </item>
	</SOAP-ENV:listAnnualReport>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response

Response is array of elements item with parameters:

  • country - country code EST is supported.
  • reg_code - registration number of company
  • doc_type - type of document A for PDF, X for XBRL, D for Digidoc
  • annual_year - year of annual report
  • description - type of document in readable form
  • created_at - date of document uploaded into registry

Use all these parameters in getAnnualReport to request necessary report.

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
				   xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
	<SOAP-ENV:listAnnualReportResponse>
	  <item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2001</annual_year>
		  <description>PDF document</description>
		  <created_at>2002-07-08</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2003</annual_year>
		  <description>PDF document</description>
		  <created_at>2004-07-12</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2008</annual_year>
		  <description>PDF document</description>
		  <created_at>2009-06-26</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2011</annual_year>
		  <description>PDF document</description>
		  <created_at>2012-06-26</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2011</annual_year>
		  <description>XBRL document</description>
		  <created_at>2012-06-26</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2000</annual_year>
		  <description>PDF document</description>
		  <created_at>2001-05-28</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2002</annual_year>
		  <description>PDF document</description>
		  <created_at>2003-07-03</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2004</annual_year>
		  <description>PDF document</description>
		  <created_at>2005-07-01</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2005</annual_year>
		  <description>PDF document</description>
		  <created_at>2006-07-03</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2007</annual_year>
		  <description>PDF document</description>
		  <created_at>2008-04-29</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2006</annual_year>
		  <description>PDF document</description>
		  <created_at>2007-06-28</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2009</annual_year>
		  <description>PDF document</description>
		  <created_at>2010-06-02</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2009</annual_year>
		  <description>XBRL document</description>
		  <created_at>2010-06-02</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2010</annual_year>
		  <description>PDF document</description>
		  <created_at>2011-06-20</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2010</annual_year>
		  <description>XBRL document</description>
		  <created_at>2011-06-20</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2012</annual_year>
		  <description>PDF document</description>
		  <created_at>2013-06-19</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>D</doc_type>
		  <annual_year>2012</annual_year>
		  <description>DDOC/BDOC container</description>
		  <created_at>2013-06-19</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2012</annual_year>
		  <description>XBRL document</description>
		  <created_at>2013-06-19</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2013</annual_year>
		  <description>PDF document</description>
		  <created_at>2014-06-18</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2013</annual_year>
		  <description>XBRL document</description>
		  <created_at>2014-06-18</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>A</doc_type>
		  <annual_year>2014</annual_year>
		  <description>PDF document</description>
		  <created_at>2015-06-15</created_at>
		</item>
		<item>
		  <country>EST</country>
		  <reg_code>10117826</reg_code>
		  <doc_type>X</doc_type>
		  <annual_year>2014</annual_year>
		  <description>XBRL document</description>
		  <created_at>2015-06-15</created_at>
		</item>
	  </item>
	</SOAP-ENV:listAnnualReportResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Errors

  • Token is wrong - you trying to access SOAP service with wrong or expired access token.
  • This request is not allowed for you - the request you trying to perform is not allowed for you. This may be a problem in our system, please contact support.
  • No such company - company you requested is not available. Check country and reg_code parameters are correct.
  • Only EST country supported in this request - currently, we have reports only for estonian companies. Change country to EST
  • Something went wrong - this is hypothetical situation, when something really went wrong

Example:

<?xml version = "1.0" encoding = "UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
	<SOAP-ENV:Fault>
	  <faultcode>SOAP-ENV:Client</faultcode>
	  <faultstring>This request is not allowed for you</faultstring>
	</SOAP-ENV:Fault>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

See also