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 }