API endpoints
- https://api.bisnode.fi/people/info/v2/person-Fatca1 - production environment
- https://api-test.bisnode.fi/people/info/v2/person-Fatca1 - test environment
API response
fieldsFields element contains all Prc and Bisndoe data parameters.isDataFoundIf data is found then "true" otherwise "false".
| Data element | Description |
|---|---|
| socialSecurityNumber | Social Security Number. e.g. "160264-999N". |
| bisnodeId | BisnodeId e.g. "FI2101005066333". |
| dateOfBirth | Person's date of birth. e.g. "1964-02-16T00:00:00Z". |
| allAddresses | List of all person's addresses. Includes the following elements: addressPriorityType, addressFormatType, streetAddress, postCode, postOffice, countryCode, countryNumber, countryName, addressMunicipalityCode, addressMunicipalityName, additionalAddressRow, dateOfAddress, startDate, endDate. |
| lastName | Person's last name. e.g. "Lepistö". |
| firstName | Person's last name. e.g. "Tobias Kullervo". |
| gender | Person's gender e.g. "F" or "M". |
| dateOfDeath | Person's date of death. e.g. "2010-01-01T00:00:00Z". |
| dateOfDeclarationOfDeath | Date when person has declared to dead. e.g. "2010-11-01T00:00:00Z". |
| languageCode | Person's language. e.g. "fi". |
| yearOfBirth | Person's birth year. e.g. 1964. |
| isDead | If person is dead. e.g. "true" or "false". |
| homeMunicipality | Includes the following elements: startedAt. e.g. "1966-06-25T00:00:00Z", homeMunicipalityType. e.g. "Domestic", code. e.g. 297, name. e.g. "Kuopio". |
| usaConnections | Includes the following elements: hasUsaCitizenship. e.g. "false", hasBornInUsa. e.g. "false". |
| hasGuardianship | Has guardianship. e.g. if has guardianship then "true" otherwise "false". |
| guardianshipDetails | Includes the following elements: CompanyAndCorporateGuardians(BusinessId,EndDate,Name,StartDate), ContainsRuleForTaskSharing, EndDate,LegalAidOfficeGuardians(Code,EndDate,Name,StartDate), PersonGuardians(DateOfBirth, EndDate,FirtName,LastName,SocialSecurityNumber,StartDate), RestrictionCode, RestrictionText, RuleForTaskSharing, StartDate. |
| warnings | Includes the following elements: code e.g. "Prc_Disclaimer", message e.g. "Package may lack addresses and other data elements because of protected identity, missing information in PRC database, or limitations relating contract or law", context e.g. "null". |
| dataSources | Contains elements: datasourceType e.g. "Prc" and list of fields: "AllAddresses.AddressFormatType", "AllAddresses.AddressPriorityType", "AllAddresses.CountryName", "AllAddresses.CountryNumber", "AllAddresses.DateOfAddress", "AllAddresses.EndDate", "AllAddresses.PostCode", "AllAddresses.PostOffice", "AllAddresses.StartDate", "AllAddresses.StreetAddress", "DateOfBirth", "DateOfDeath", "DateOfDeclarationOfDeath", "FirstName", "Gender", "HomeMunicipality.Code", "HomeMunicipality.HomeMunicipalityType", "HomeMunicipality.Name", "HomeMunicipality.StartedAt", "IsDead", "LanguageCode", "LastName", "SocialSecurityNumber", "YearOfBirth". |
| dataSourceType | Type of datasource. e.g. "Bisnode", "Prc". |
| fields | Fields element contains all Prc and Bisnode data parameters. |
| isDataFound | If data is found then "true" otherwise "false". |
API request parameters
| Parameter | Description | |
|---|---|---|
| id |
Social security number or BisnodeId |
M |
| reference | ||
| M = Mandatory | ||
API request and response example: with socialSecurityNumber.
curl -X GET 'https://api-test.bisnode.fi/people/info/v2/person-Fatca1?id=021081-998E&=' -H 'ticket: 1234567890ABC'
Successful request and the API return results in JSON form
"data": {
"bisnodeId": null,
"socialSecurityNumber": "021081-998E",
"dateOfBirth": "1981-10-02T00:00:00Z",
"allAddresses": [
{
"addressPriorityType": "Permanent",
"addressFormatType": "Domestic",
"streetAddress": "Mäkikaivontie 12 C 39a",
"postCode": "65100",
"postOffice": "VAASA",
"countryCode": "FI",
"countryNumber": 246,
"countryName": null,
"addressMunicipalityCode": null,
"addressMunicipalityName": null,
"additionalAddressRow": null,
"dateOfAddress": "1981-10-02T00:00:00Z",
"startDate": "1981-10-02T00:00:00Z",
"endDate": null
}
],
"lastName": "Karttunen",
"firstName": "Alli Kukka-Maaria",
"gender": "F",
"languageCode": "fi",
"yearOfBirth": 1981,
"dateOfDeath": null,
"dateOfDeclarationOfDeath": null,
"isDead": false,
"movedToFinland": null,
"homeMunicipality": {
"startedAt": "1981-10-02T00:00:00Z",
"homeMunicipalityType": "Domestic",
"code": 905,
"name": "Vaasa"
},
"placeOfBirth": null,
"nameHistory": null,
"usaConnections": {
"hasUsaCitizenship": false,
"hasBornInUsa": false
},
"hasGuardianship": true,
"guardianshipDetails": {
"containsRuleForTaskSharing": false,
"ruleForTaskSharing": "",
"restrictionCode": "NotRestricted",
"restrictionText": "Ei rajoitettu",
"startDate": "2009-02-10T00:00:00Z",
"endDate": null,
"personGuardians": [
{
"socialSecurityNumber": "",
"dateOfBirth": null,
"firstName": "",
"lastName": "",
"startDate": null,
"endDate": null
}
],
"companyAndCorporateGuardians": [
{
"businessId": "",
"name": "",
"startDate": null,
"endDate": null
}
],
"municipalityGuardians": null,
"legalAidOfficeGuardians": [
{
"code": "374",
"name": "Espoon oikeusaputoimisto",
"startDate": "2009-02-10T00:00:00Z",
"endDate": null
}
]
},
"maritalStatus": null,
"previousKnownMaritalStatus": null,
"continuingPowerOfAttorney": null,
"ownershipInfo": null,
"nationalities": null,
"dependentCount": null,
"livingConditions": null,
"childsGuardians": null
},
"warnings": [
{
"code": "Prc_Disclaimer",
"message": "Package may lack addresses and other data elements because of protected identity, missing information in PRC database, or limitations relating contract or law",
"context": null
}
],
"dataSources": [
{
"datasourceType": "Prc",
"fields": [
"AllAddresses.AddressFormatType",
"AllAddresses.AddressPriorityType",
"AllAddresses.CountryName",
"AllAddresses.CountryNumber",
"AllAddresses.DateOfAddress",
"AllAddresses.EndDate",
"AllAddresses.PostCode",
"AllAddresses.PostOffice",
"AllAddresses.StartDate",
"AllAddresses.StreetAddress",
"ContinuingPowerOfAttorney.AuthorizedDonees.DateOfBirth",
"ContinuingPowerOfAttorney.AuthorizedDonees.EndDate",
"ContinuingPowerOfAttorney.AuthorizedDonees.FirstName",
"ContinuingPowerOfAttorney.AuthorizedDonees.LastName",
"ContinuingPowerOfAttorney.AuthorizedDonees.SocialSecurityNumber",
"ContinuingPowerOfAttorney.AuthorizedDonees.StartDate",
"ContinuingPowerOfAttorney.ContainsRuleForTaskSharing",
"ContinuingPowerOfAttorney.EndDate",
"ContinuingPowerOfAttorney.RuleForTaskSharing",
"ContinuingPowerOfAttorney.StartDate",
"DateOfBirth",
"DateOfDeath",
"DateOfDeclarationOfDeath",
"FirstName",
"Gender",
"GuardianshipDetails.CompanyAndCorporateGuardians.BusinessId",
"GuardianshipDetails.CompanyAndCorporateGuardians.EndDate",
"GuardianshipDetails.CompanyAndCorporateGuardians.Name",
"GuardianshipDetails.CompanyAndCorporateGuardians.StartDate",
"GuardianshipDetails.ContainsRuleForTaskSharing",
"GuardianshipDetails.EndDate",
"GuardianshipDetails.LegalAidOfficeGuardians.Code",
"GuardianshipDetails.LegalAidOfficeGuardians.EndDate",
"GuardianshipDetails.LegalAidOfficeGuardians.Name",
"GuardianshipDetails.LegalAidOfficeGuardians.StartDate",
"GuardianshipDetails.PersonGuardians.DateOfBirth",
"GuardianshipDetails.PersonGuardians.EndDate",
"GuardianshipDetails.PersonGuardians.FirstName",
"GuardianshipDetails.PersonGuardians.LastName",
"GuardianshipDetails.PersonGuardians.SocialSecurityNumber",
"GuardianshipDetails.PersonGuardians.StartDate",
"GuardianshipDetails.RestrictionCode",
"GuardianshipDetails.RestrictionText",
"GuardianshipDetails.RuleForTaskSharing",
"GuardianshipDetails.StartDate",
"HasGuardianship",
"HomeMunicipality.Code",
"HomeMunicipality.HomeMunicipalityType",
"HomeMunicipality.Name",
"HomeMunicipality.StartedAt",
"IsDead",
"IsRequestedSocialSecurityNumberPassivated",
"LanguageCode",
"LastName",
"PlaceOfBirth.CountryCodeIso31661Numeric",
"PlaceOfBirth.MunicipalityCode",
"PlaceOfBirth.PlaceOfBirth",
"SocialSecurityNumber",
"UsaConnections.HasBornInUsa",
"UsaConnections.HasUsaCitizenship",
"YearOfBirth"
]
},
{
"datasourceType": "Bisnode",
"fields": [
"AllAddresses.CountryCode"
]
}
],
"isDataFound": true
}