API endpoints
- https://api.bisnode.fi/ihmiset/v1/FieldSearch - production environment
- https://api-test.bisnode.fi/ihmiset/v1/FieldSearch - test environment
API response
| Data element | Description |
|---|---|
| BisnodeId | The unique person id. e.g. FI2101004131266 |
| Lastname | Person's last name. e.g. Kankkunen |
| Firstname | Person's first names (or name). e.g. Juha |
| Address | It contains only the street name. Does not contains any street number information. e.g. Kauppakatu |
| PostOffice | Person's current post office. e.g. Helsinki |
API request parameters
| Parameter | Description | |
|---|---|---|
| Lastname | Last name of the person. e.g. Pouta | * |
| Firstname | First name (or names) of the person. e.g. Matti | * |
| Streetname | Only street name, don't use street number information. e.g. Kauppakatu | * |
| Zipcode | Zip/Postal code. e.g. 78200 | * |
| Postoffice | Post office. e.g. Helsinki | * |
| Phonenumber | Phone number of the person. e.g. 044983923 | * |
| *) At least one request parameter should be used. | ||
API request and response example
curl 'https://api.bisnode.fi/ihmiset/v1/FieldSearch?lastname=Laaksonen&zipcode=00980' -H 'x-api-key: 1234567890ABC'
Successful request and the API return results in JSON form
{
"Persons": [
{
"BisnodeId": "FI2101004338470",
"Lastname": "Laaksonen",
"Firstname": "Jukka",
"Address": "Kumpulantie",
"PostOffice": "HELSINKI"
},
{
"BisnodeId": "FI2101004237425",
"Lastname": "Laaksonen",
"Firstname": "Jari",
"Address": "Kauppakatu",
"PostOffice": "HELSINKI"
},
{
"BisnodeId": "FI2101004561468",
"Lastname": "Laaksonen",
"Firstname": "Janne",
"Address": "Kuusitie",
"PostOffice": "HELSINKI"
}
],
"Total": 11
}