API endpoints
- https://api.bisnode.fi/yritykset/v1/ProcurationInfo - production environment
- https://api-test.bisnode.fi/yritykset/v1/ProcurationInfo - test environment
API request parameters
| Parameter | Description | |
|---|---|---|
| id | Business id or person id | X |
| X = Mandatory | ||
GET https://api-test.bisnode.fi/yritykset/v1/ProcurationInfo?id={id}
API response
| Element | Description |
|---|---|
| businessId | The company's business id |
| companyName | The company name |
| status | The company's status code (activity) |
| statusDescription | The status code description in Finnish, Swedish and English |
| procurationAbstract | The company's signing rule code |
| procurationAbstractDescription | The company's signing rule description in Finnish, Swedish and English |
| registrationDate | Registration Date |
| procurationPerson | They have the signing rights, but they are not the board members are listed here. |
| personId | Person id (ssn). If a person is not Finnish citizen, then only the date of birth |
| personName | Person first and last name |
| roleType | Role code |
| roleTypeDescription | Role description in Finnish, Swedish and English |
| procurationCode | Procuration code. Only role types PR and OI |
| procurationCode | Procuration description in Finnish, Swedish and English |
| validFrom | Date when the person has been in this role. |
| protectionOfInterests | This element show e.g. information of the guardianship. |
| descriptionOfProtectionOfInterests | Description in Finnish, Swedish and English |
API request and response example
curl 'https://api-test.bisnode.fi/yritykset/v1/ProcurationInfo?id=2014838-7' -H 'ticket: 1234567890ABC'
Successful request and the API return results in JSON format.
{
"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": "260264-XXXX",
"personName": "Koponen Sari Kristiina",
"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": "090359-XXXX",
"firstname": "Kari Pekka",
"lastname": "Ruskola",
"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": "120565",
"firstname": "Karl Peter",
"lastname": "Bergson",
"role": [
{
"role": "HVJ",
"roleDescription": [
{
"language": "English",
"description": "Ordinary member"
},
{
"language": "Swedish",
"description": "Ordinarie medlem"
},
{
"language": "Finnish",
"description": "Varsinainen jäsen"
}
],
"validFrom": "2016-11-08T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "180265-XXXX",
"firstname": "Juha Pekka",
"lastname": "Airaksinen",
"role": [
{
"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": "230665",
"firstname": "Ulla Karin Maria",
"lastname": "Sandsjö",
"role": [
{
"role": "HVJ",
"roleDescription": [
{
"language": "English",
"description": "Ordinary member"
},
{
"language": "Swedish",
"description": "Ordinarie medlem"
},
{
"language": "Finnish",
"description": "Varsinainen jäsen"
}
],
"validFrom": "2016-11-08T00:00:00"
}
],
"protectionOfInterests": null,
"descriptionOfProtectionOfInterests": null
},
{
"personId": "260264-XXXX",
"firstname": "Sari Kristiina",
"lastname": "Koponen",
"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
},
{
"personId": "280973",
"firstname": "Hans Magnus",
"lastname": "Silfverberg",
"role": [
{
"role": "HPJ",
"roleDescription": [
{
"language": "English",
"description": "Chairperson"
},
{
"language": "Swedish",
"description": "Ordförande"
},
{
"language": "Finnish",
"description": "Puheenjohtaja"
}
],
"validFrom": "2016-11-08T00: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
}