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 }