Signing Information

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY (it's called a ticket) by using the ticket API (Please, read how to use ticket API instructions).

The API KEY must be sent in the request custom header element (named ticket or x-api-key). If the API KEY value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS.

Information returned by the interface

Information	Description
Business ID
Business Name	Companys´ official tradename.
Status	Is the company active or passive.
Procuration
Person Name
Date of Birth
Role	for example holders of procuration and board members.
Attention! Information provided varies depending on company form, information registered of the company and company status. Above are listed the most common information available.

 

Interface addresses

• https://api.bisnode.fi/yritykset/v1/ProcurationInfo - Tuotantoympäristö
• https://test.bisnode.fi/yritykset/v1/ProcurationInfo - Testiympäristö

 

Interface request parameters

Parameter	Description
id	Business ID or person ID, that can be put with hyphen or without	X
X = Mandatory

 

Example of question and answer of the interface

https://api.bisnode.fi/yritykset/v1/ProcurationInfo?id=2014838-7

The request succeeded and the interface returned the information in JSON-form

{
"company": [
{
"businessId": "2014838-7",
"companyName": "Bisnode Finland Oy",
"status": "100",
"statusDescription": [
{
"language": "English",
"description": "Active"
},
{
"language": "Swedish",
"description": "Aktiv "
},
{
"language": "Finnish",
"description": "Aktiivinen"
}
],
"procurationAbstract": "NIMA12",
"procurationAbstractDescription": [
{
"language": "English",
"description": "By the Chair of the Board and the Managing Director, each on their own, and by any two Board members jointly"
},
{
"language": "Swedish",
"description": "Styrelsens ordförande och verkställande direktören vardera ensam samt två styrelsemedlemmar gemensamt"
},
{
"language": "Finnish",
"description": "Hallituksen puheenjohtaja ja toimitusjohtaja kumpikin yksin ja hallituksen jäsenet kaksi yhdessä"
}
],
"registrationDate": "2006-02-13T00:00:00",
"procurationPerson": [
{
"personId": "XXXXXX",
"personName": "Laitinen Sari Tiina",
"role": [
{
"roleType": "PR",
"roleTypeDescription": [
{
"language": "English",
"description": "Holder of procuration"
},
{
"language": "Swedish",
"description": "Prokurist"
},
{
"language": "Finnish",
"description": "Prokuristi"
}
],
"procurationCode": "01",
"procurationDescription": [
{
"language": "English",
"description": "Representation by the holders of a procuration as follows: on his or her own."
},
{
"language": "Swedish",
"description": "Prokuristerna företräder bolaget ensam."
},
{
"language": "Finnish",
"description": "Prokuristit edustavat yhtiötä kukin yksin."
}
],
"validFrom": "2006-02-13T02:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
}
],
"board": {
"naturalPerson": [
{
"personId": "XXXXXX",
"firstname": "Mats Kalle",
"lastname": "Bergman",
"role": [
{
"role": "HPJ",
"roleDescription": [
{
"language": "English",
"description": "Chairperson"
},
{
"language": "Swedish",
"description": "Ordförande"
},
{
"language": "Finnish",
"description": "Puheenjohtaja"
}
],
"validFrom": "2015-06-26T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "XXXXXX",
"firstname": "Kari Janne",
"lastname": "Huutola",
"role": [
{
"role": "PTI",
"roleDescription": [
{
"language": "English",
"description": "Auditor with principal responsibility"
},
{
"language": "Swedish",
"description": "Huvudansvarig revisor"
},
{
"language": "Finnish",
"description": "Päävastuullinen tilintarkastaja"
}
],
"validFrom": "2012-01-17T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "XXXXXX",
"firstname": "Karl Mats",
"lastname": "Johnsson",
"role": [
{
"role": "HVJ",
"roleDescription": [
{
"language": "English",
"description": "Ordinary member"
},
{
"language": "Swedish",
"description": "Ordinarie medlem"
},
{
"language": "Finnish",
"description": "Varsinainen jäsen"
}
],
"validFrom": "2015-06-26T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "XXXXXX",
"firstname": "Juha Matti",
"lastname": "Ruuskanen",
"role": [
{
"role": "HVJ",
"roleDescription": [
{
"language": "English",
"description": "Ordinary member"
},
{
"language": "Swedish",
"description": "Ordinarie medlem"
},
{
"language": "Finnish",
"description": "Varsinainen jäsen"
}
],
"validFrom": "2015-06-26T00:00:00"
},
{
"role": "TJ",
"roleDescription": [
{
"language": "English",
"description": "Managing Director"
},
{
"language": "Swedish",
"description": "Verkställande direktör"
},
{
"language": "Finnish",
"description": "Toimitusjohtaja"
}
],
"validFrom": "2006-02-13T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "XXXXXX",
"firstname": "Sari Minna",
"lastname": "Koskinen",
"role": [
{
"role": "PR",
"roleDescription": [
{
"language": "English",
"description": "Holder of procuration"
},
{
"language": "Swedish",
"description": "Prokurist"
},
{
"language": "Finnish",
"description": "Prokuristi"
}
],
"validFrom": "2006-02-13T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
}
],
"juristicPerson": [
{
"name": "PricewaterhouseCoopers Oy ",
"role": [
{
"role": "TIL",
"roleDescription": [
{
"language": "English",
"description": "Auditor"
},
{
"language": "Swedish",
"description": "Revisor"
},
{
"language": "Finnish",
"description": "Tilintarkastaja"
}
],
"validFrom": "2012-01-17T00:00:00"
}
]
}
]
}
}
],
"Error": null

Attention! To use the interface you have to have a valid ticket (check out the quickquide), that has to be sent with the request, in header- element (ticket-parameters). Requests to production- and test enviroments always have to be made encrypted in https-form. In addition, enviroment based (production- and test enviroment) logins have to have valid access rights defined by Bisnode.

Please note that data coverage varies between companies. Data coverage depends e.g. on company form. Remember the codes and descriptions API returns all companies REST APIs code values and descriptions - read more.