API endpoints
- https://api.bisnode.fi/ihmiset/v1/PersonExtended - production environment
- https://api-test.bisnode.fi/ihmiset/v1/PersonExtended - test environment
API response
| Data element | Description |
|---|---|
| BisnodeId | The unique person id. |
| Lastname | Person's last name. |
| Firstname | Person's first name. |
| Address | Person's address |
| Zipcode | Person's zipcode. |
| PostOffice | Person's post office. |
| DateOfAddress | Date when person moved to their current address. |
| PhoneNumber | Person's phone number. |
| Gender | Is person male or female. |
| Languagecode | Person's language code, e.g. 'fi' |
| YearOfBirth | Person's year of birth. |
| Status | Is the person alive or dead |
| DateOfDeath | Date of death (if person is dead). |
API request parameters
| Parameter | Description | |
|---|---|---|
| id | Bisnode ID or social security number*. | X |
| reference | The end user name or id** | |
| X = Mandatory, * = Only in credit check use, ** = Mandatory in credit check use | ||
https://api.bisnode.fi/ihmiset/v1/PersonExtended?id={id}&reference={reference}
API request and response example
https://api.bisnode.fi/ihmiset/v1/PersonExtended?id=FI2101005032599
Successful request and the API return results in JSON format.
{
"Gender": "M",
"Languagecode": "fi",
"YearOfBirth": 1985,
"DateOfAddress": "2013-06-01T00:00:00",
"DateOfDeath": null,
"Status": "ALIVE",
"BisnodeId": "FI2101005032599",
"Lastname": "Meikäläinen",
"Firstname": "Matti Olavi",
"Address": "Kauppakatu 63 A 2",
"Zipcode": "00980",
"PostOffice": "HELSINKI",
"PhoneNumber": "0501234567"
}