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 | X |
reference | The end user name or id | |
X = Mandatory |
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" }