API endpoints
- https://api.bisnode.fi/yritykset/v1/getdecisionmakers - production environment
- https://api-test.bisnode.fi/yritykset/v1/getdecisionmakers - test environment
API request parameters
| Parameter | Description | |
|---|---|---|
| id | Company's business id or duns number | X |
| X = Mandatory | ||
GET https://api-test.bisnode.fi/yritykset/v1/getdecisionmakers?id={id}
API response
| Element | Description |
|---|---|
| name | The company name |
| regNo | The company's business id |
| duns | The company's duns number |
| conditionCode | The company's status code (activity) |
| conditionDescr_En | The status code description in English |
| conditionDescr_Fi | The status code description in Finnish |
| lastName | Decision maker's last name |
| firstName | Decision maker's first name |
| title | Decision maker's title/role |
| Decision maker's email address | |
| phone | Decision maker's phone number |
| dateLastChecked | Date when the information was last checked |
| functionCode | Decision maker's responsibility code |
| functionDescr_En | The responsibility code description in English |
| functionDescr_FI | The responsibility code description in Finnish |
API request and response example
curl 'https://api-test.bisnode.fi/yritykset/v1/getdecisionmakers?id=2014838-7' -H 'ticket: 1234567890ABC'
Successful request and the API return results in JSON format.
{
"name": "Bisnode Finland Oy",
"regNo": "20148387",
"duns": "539506084",
"condition": {
"conditionCode": "100",
"conditionDescr_En": "Active",
"conditionDescr_Fi": "Aktiivinen"
},
"leader": [
{
"idNo": 3655855,
"lastName": "Meikäläinen",
"firstName": "Tomi",
"title": "Toimitusjohtaja",
"eMail": "tomi.meikalainen@esimerkki.fi",
"phone": "044 7882332",
"dateLastChecked": 20161208,
"responsibility": [
{
"functionCode": "1100",
"functionDescr_En": "Top Management, CEO",
"functionDescr_FI": "Ylin johto, CEO"
}
]
},
{
"idNo": 3934478,
"lastName": "Kemppainen",
"firstName": "Arja",
"title": "Markkinointipäällikkö",
"eMail": "arja.kemppainen@esimerkki.fi",
"dateLastChecked": 20151215,
"responsibility": [
{
"functionCode": "1400",
"functionDescr_En": "Marketing",
"functionDescr_FI": "Markkinointi"
}
]
},
{
"idNo": 3934479,
"lastName": "Mykkänen",
"firstName": "Joonas",
"title": "Myyntijohtaja",
"eMail": "joonas.mykkanen@esimerkki.fi",
"phone": "040 4440921",
"dateLastChecked": 20151215,
"responsibility": [
{
"functionCode": "1300",
"functionDescr_En": "Sales",
"functionDescr_FI": "Myynti"
}
]
},
{
"idNo": 3934480,
"lastName": "Meikäläinen",
"firstName": "Pasi",
"title": "Teknologiajohtaja",
"eMail": "pasi.meikalainen@esimerkki.fi",
"phone": "040 63728323",
"dateLastChecked": 20151215,
"responsibility": [
{
"functionCode": "1600",
"functionDescr_En": "ICT",
"functionDescr_FI": "ICT"
},
{
"functionCode": "1800",
"functionDescr_En": "Production",
"functionDescr_FI": "Tuotanto"
},
{
"functionCode": "2000",
"functionDescr_En": "Research And Development",
"functionDescr_FI": "Tutkimus & Kehitys"
}
]
},
{
"idNo": 4048673,
"lastName": "Makkonen",
"firstName": "Minna",
"eMail": "minna.makkonen@esimerkki.fi",
"dateLastChecked": 20151215,
"responsibility": [
{
"functionCode": "2300",
"functionDescr_En": "Customer Service",
"functionDescr_FI": "Asiakaspalvelu"
}
]
}
]
}