getFreeInfo

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

get company free information (general information, contact data)

Request parameters

You have to perform POST request with JSON-encoded parameters:

• token - access token (required)
• country - country code EST, LTU or LVA (optional, default 'EST')
• reg_code - registration number of company (optional, default 10117826 Bisnode)
• language - language of results en,et or ru (optional, default en)
• customer - if you're reseller, you can add a note about your customer here. Used only in log file, you can search and filter log by this parameter (optional)

Example:

{
	"token": "0c725874e737c8195de547f67692d8b976726561",
	"country": "EST",
	"reg_code": "10117826",
	"language": "en",
	"customer": "documentation"
}

Response

Response consist of elements:

• general - general company information
• contacts - contacts information (telephone, www)
• old_names - previous company names
• payment_remarks - payment remarks (requested online from Maksuamet)
• debts_rating - debts rating (exists or none)
• last_annual_report - year of latest annual report

Example:

{
	"general": {
		"company_name": "BISNODE ESTONIA AS",
		"company_type": "Public limited company",
		"company_type_code": "Public limited company",
		"status": "Active",
		"status_code": "active",
		"deletion_date": null,
		"registration_number": "10117826",
		"registration_date": "1996-11-18",
		"registered_capital": "25560.0",
		"registered_capital_currency": "EUR",
		"vat_number": "EE100106532",
		"address": "Estonia pst 5, 10143, Tallinna linn, Harju maakond",
		"activity": "63.99"
	},
	"contacts": [
		{
			"type": "Address",
			"type_code": "ADDRESS",
			"content": "Estonia pst 5, 10143, Tallinna linn, Harju maakond"
		},
		{
			"type": "Telephone",
			"type_code": "TEL",
			"content": "+372 6414910"
		},
		{
			"type": "E-mail address",
			"type_code": "EMAIL",
			"content": "info@bisnode.ee"
		},
		{
			"type": "Internet address (www)",
			"type_code": "WWW",
			"content": "www.bisnode.ee"
		}
	],
	"old_names": [
		"aktsiaselts CONNECTUS",
		"Aktsiaselts BISNODE ESTONIA"
	],
	"payment_remarks": [

	],
	"debts_rating": {
		"code": 1,
		"status": "None",
		"color": "green"
	},
	"last_annual_report": 2014
}

Error messages

• 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.

• Only EST country supported in this request - change country to EST

• No such company - company you requested is not available. Check country and reg_code parameters are correct.

Example:

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

See also

• SOAP documentation
• REST documentation