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

Get AAA rating of company with additional calculation details

Request

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)
  • 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)
  • language - language of results en,et or ru (optional, default en)

Example:

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

Response

Parts of response:

  • action - name of function you've called
  • general - general company information
  • aaa_rating - structure with parameters operation_rating, background_rating, finance_rating, atp_rating, aaa_rating and credit_limit. Each of them have code, status and color parameters.

Example:

{
	"action": "getAaaRating",
	"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"
	},
	"aaa_rating": {
		"operation_rating": {
			"code": "A-EST",
			"status": "Established",
			"color": "green"
		},
		"background_rating": {
			"code": "D-POSI",
			"status": "Positive",
			"color": "green"
		},
		"finance_rating": {
			"code": "G-EXCE",
			"status": "Excellent",
			"color": "green"
		},
		"atp_rating": {
			"code": "A-NEUT",
			"status": "Not negative",
			"color": "green"
		},
		"aaa_rating": {
			"code": "AAA",
			"status": "Highest Creditworthiness",
			"color": "green"
		},
		"credit_limit": {
			"code": 1,
			"status": "112022 EUR",
			"color": "green"
		}
	}
}

Error messages

In case of fatal problem, instead of result you will receive an error message

  • 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

Example:

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

See also