Companies REST API

Codes and descriptions

The Codes and Descriptions API returns all codes values and descriptions which companies REST APIs contains.

Endpoints

  • https://api.bisnode.fi/company/info/v2/codes - production environment
  • https://api-test.bisnode.fi/company/info/v2/codes - test environment

Request

ParameterDescription 
id Code key X

GET https://api-test.bisnode.fi/company/info/v2/codes/{id}

Response

ElementDescription
codeKey  
codeName  
codeNameEnglish  
codeNameSwedish  

Request and response example

curl 'https://api-test.bisnode.fi/company/info/v2/codes/RAC' -H 'x-api-key: 1234567890ABC'

Successful request and the API returns results in JSON format.

{
    "codeKey": "RAC",
    "codeName": "Rating-koodit",
    "codeNameEnglish": "Rating codes",
    "codeNameSwedish": "Rating-koder",
    "codes": [
        {
            "codeValue": "AA",
            "codeDescription": "Hyvä luottokelpoisuus",
            "codeDescriptionEnglish": "Good Creditworthness",
            "codeDescriptionSwedish": "God kreditvärdighet"
        },
        {
            "codeValue": "AN",
            "codeDescription": "Toiminta uutta / tausta ei negatiivinen",
            "codeDescriptionEnglish": "New company with positive background",
            "codeDescriptionSwedish": "Nystartat företag"
        },
        {
            "codeValue": "A",
            "codeDescription": "Luottokelpoinen",
            "codeDescriptionEnglish": "Creditworthy",
            "codeDescriptionSwedish": "Kreditvärdig"
        },
        {
            "codeValue": "EIRA",
            "codeDescription": "Ei rating",
            "codeDescriptionEnglish": "Not rated",
            "codeDescriptionSwedish": "Rating ej fastställd"
        },
        {
            "codeValue": "B",
            "codeDescription": "Epätyydyttävä",
            "codeDescriptionEnglish": "Credit against securities",
            "codeDescriptionSwedish": "Kredit mot säkerhet"
        },
        {
            "codeValue": "C",
            "codeDescription": "Luotonantoa ei puolleta",
            "codeDescriptionEnglish": "Credit rejected",
            "codeDescriptionSwedish": "Kredit avrådes"
        },
        {
            "codeValue": "AAA",
            "codeDescription": "Korkein luottoluokitus",
            "codeDescriptionEnglish": "Highest Creditwortness",
            "codeDescriptionSwedish": "Högsta kreditvärdighet"
        }
    ]
}

SWAGGER - Developer REST API documentation - read more »

Here you can download all codes and descriptions (XLSX file)