listAnnualReport

https://in.bisnode.ee/rest/listAnnualReport

List annual reports available to buy in registry.

Request parameters

You have to perform POST request with JSON-encoded 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:

{
	"token": "0c725874e737c8195de547f67692d8b976726561",
	"country": "EST",
	"reg_code": "10117826"
}

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:

[
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2001,
		"description": "PDF document",
		"created_at": "2002-07-08"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2003,
		"description": "PDF document",
		"created_at": "2004-07-12"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2008,
		"description": "PDF document",
		"created_at": "2009-06-26"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2011,
		"description": "PDF document",
		"created_at": "2012-06-26"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "X",
		"annual_year": 2011,
		"description": "XBRL document",
		"created_at": "2012-06-26"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2000,
		"description": "PDF document",
		"created_at": "2001-05-28"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2002,
		"description": "PDF document",
		"created_at": "2003-07-03"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2004,
		"description": "PDF document",
		"created_at": "2005-07-01"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2005,
		"description": "PDF document",
		"created_at": "2006-07-03"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2007,
		"description": "PDF document",
		"created_at": "2008-04-29"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2006,
		"description": "PDF document",
		"created_at": "2007-06-28"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2009,
		"description": "PDF document",
		"created_at": "2010-06-02"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "X",
		"annual_year": 2009,
		"description": "XBRL document",
		"created_at": "2010-06-02"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "A",
		"annual_year": 2010,
		"description": "PDF document",
		"created_at": "2011-06-20"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "X",
		"annual_year": 2010,
		"description": "XBRL document",
		"created_at": "2011-06-20"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "A",
		"annual_year": "2012",
		"description": "PDF document",
		"created_at": "2013-06-19"
	},
	{
		"country": "EST",
		"reg_code": 10117826,
		"doc_type": "D",
		"annual_year": 2012,
		"description": "DDOC\/BDOC container",
		"created_at": "2013-06-19"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "X",
		"annual_year": "2012",
		"description": "XBRL document",
		"created_at": "2013-06-19"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "A",
		"annual_year": "2013",
		"description": "PDF document",
		"created_at": "2014-06-18"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "X",
		"annual_year": "2013",
		"description": "XBRL document",
		"created_at": "2014-06-18"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "A",
		"annual_year": "2014",
		"description": "PDF document",
		"created_at": "2015-06-15"
	},
	{
		"country": "EST",
		"reg_code": "10117826",
		"doc_type": "X",
		"annual_year": "2014",
		"description": "XBRL document",
		"created_at": "2015-06-15"
	}
]

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:

{
	"error": "error",
	"code": 0,
	"message": "This request is not allowed for you"
}

See also

• SOAP documentation
• REST documentation