Menu
People API

Family, education and background

The API return the person's family, education and background in JSON format, as specified by Bisnode ID.

API response

Data elementDescription
BisnodeId The unique person id
Person's education level Estimated education level (personal) is shown in classes 1-10. Class 1: low educated. Class 10: highly educated.
Household's education level Estimated education level (household) is shown in classes 1-10. Class 1: low educated. Class 10: highly educated.
Households with children under 18 years Under 18-year-old minors live in this household are shown in classes 1-10. Class 1: no. Class 10: yes.
Households with children under 10 years Under 10 years old minors live in this household are shown in classes 1-10. Class 1: no. Class 10: yes.
Households with children over 10 years Over 10 years old minors live in this household are shown in classes 1-10. Class 1: no. Class 10: yes.
Person's ownership of home Person's living form estimated probability is shown in classes 1-10. Class 1: living in owner-occupied housing, Class 10: lives in rented housing.
Car ownership Car ownership prediction are shown in classes 1-10. Class 1: no. Class 10: yes.

API request parameters

ParameterDescription 
id Bisnode ID X

https://api-test.bisnode.fi/ihmiset/v1/Family?id={id}

API endpoints

  • https://api-test.bisnode.fi/ihmiset/v1/Family - test environment

This API has limited usage. Each api key is allowed to make 100 000 requests per month. In order to use the API you must have a valid api key on test environment and it must be sent in the request custom header element (named x-api-key). If the api key value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS.

cURL request example

curl 'https://api-test.bisnode.fi/ihmiset/v1/Family?id=FI2101004932316' -H 'x-api-key: 1234567890ABC'

API request and response example

GET https://api-test.bisnode.fi/ihmiset/v1/Family?id=FI2101004932316

Successful request and the API return results in JSON format.

{
    "BisnodeId": "FI2101004932316",
    "Person_education": 8,
    "Household_education": 6,
    "Family_with_children": 8,
    "Family_with_children_under_10": 7,
    "Family_with_children_10_to_17": 10,
    "Residency": 7,
    "Car_ownership": 9
}
Tulosta

Läs mer om våra tjänster på www.bisnode.com Bisnode