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. e.g. FI2101005032599 |
| Lastname | Person's last name. e.g. Meikäläinen |
| Firstname | Person's first name. e.g. Matti Olavi |
| Address | Person's address. e.g. Kauppakatu 63 A 2 |
| Zipcode | Person's zipcode. e.g. 00980 |
| PostOffice | Person's post office. e.g. HELSINKI |
| DateOfAddress | Date when person moved to their current address. e.g. 2013-06-01T00:00:00 |
| PhoneNumber | Person's phone number. e.g. 0501234567 |
| Gender | Is person male or female. e.g. M |
| Languagecode | Person's language code. e.g. fi |
| YearOfBirth | Person's year of birth. e.g. 1985 |
| Status | Is the person alive or dead. e.g. ALIVE |
| 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"
}