People rest API

Credit remarks

The API return information of the person's credit remarks in JSON format, as specified by Bisnode ID or person identification number.

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY (it's called a ticket) by using the ticket API (Please, read how to use ticket API).

The API KEY must be sent in the request custom header element (named ticket or 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. REQUEST THE username and password

API endpoints

  • https://api.bisnode.fi/people/info/v2/remarks/ - production environment
  • https://api-test.bisnode.fi/people/info/v2/remarks/ - test environment

API response

Data elementDescription
Social Security Number Social security number. e.g 160162-9968
Bisnode ID Bisnode ID. e.g. FI2101006369103
Date Of Birth Date of birth. e.g. 1962-01-16T00:00:00Z
Remark ID Remark ID. e.g. 14601863
Amount Amount of euros (€). e.g. 100
Case ID Case ID. e.g. 2014/123456
Additional info Other info. e.g. null
Creditor Creditor. e.g. Länsi-Suomen veronkanto- ja perintäyksikkö
Remark source Source of the remark. e.g. Ulosottovirasto
Remark code Remark code. e.g. UMV
Case type code Case type code. e.g. MUU
Remark type Type of the remark. e.g. PaymentRemark
Remark date Date of the remark. e.g. 2014-07-15T00:00:00Z
Remark paid date Remard paid date. e.g. null
Remark valid to date Date of the remark valid to date. e.g. 2018-07-15T00:00:00Z
Remark expires date Date of the remark expires date. e.g. 2018-07-15T00:00:00Z
Incident Id Incident ID. e.g. null

API request parameters

ParameterDescription 
id Bisnode ID or social security number*. X
purpose Purpose code: 1=Application for credit, 2=Credit sale control, 3=Debt collection, 5=Key-person of a company, 6=Applicant's own approval, 7=Agreement of lease, 8=Evaluation of employer/job-seeker, 9=Authority's right for information, A=Guarantee or pledge, B=Definition of agreement. X

API request and response example

https://api-test.bisnode.fi/people/info/v2/remarks/160162-9968?purposeCode=6

Successful request and the API return results in JSON format

{
  "socialSecurityNumber": "160162-9968",
  "bisnodeId": "FI2101006369103",
  "dateOfBirth": "1962-01-16T00:00:00Z",
  "remarks": [
    {
      "remarkId": 14601863,
      "amount": 0,
      "caseId": null,
      "additionalInfo": null,
      "creditor": null,
      "remarkSource": "Oikeusrekisterikeskus",
      "remarkCode": "LTV",
      "caseTypeCode": "MUU",
      "remarkType": "BusinessBanRemark",
      "remarkDate": "2016-09-06T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": null,
      "remarkExpiresDate": null,
      "incidentId": null
    },
    {
      "remarkId": 4366872,
      "amount": 0,
      "caseId": null,
      "additionalInfo": null,
      "creditor": null,
      "remarkSource": "Oikeusrekisterikeskus",
      "remarkCode": "HAK",
      "caseTypeCode": "MUU",
      "remarkType": "OtherRemark",
      "remarkDate": "2008-02-20T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": null,
      "remarkExpiresDate": null,
      "incidentId": "126557"
    },
    {
      "remarkId": 10927773,
      "amount": 0,
      "caseId": null,
      "additionalInfo": null,
      "creditor": null,
      "remarkSource": "Oikeusrekisterikeskus",
      "remarkCode": "KHV",
      "caseTypeCode": "MUU",
      "remarkType": "OtherRemark",
      "remarkDate": "2014-10-01T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": null,
      "remarkExpiresDate": null,
      "incidentId": "445236"
    },
    {
      "remarkId": 10927774,
      "amount": 0,
      "caseId": null,
      "additionalInfo": null,
      "creditor": null,
      "remarkSource": "Oikeusrekisterikeskus",
      "remarkCode": "KJS",
      "caseTypeCode": "MUU",
      "remarkType": "OtherRemark",
      "remarkDate": "2014-10-08T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": null,
      "remarkExpiresDate": null,
      "incidentId": "445236"
    },
    {
      "remarkId": 10927701,
      "amount": 105,
      "caseId": "2014/123456",
      "additionalInfo": null,
      "creditor": "Länsi-Suomen veronkanto- ja perintäyksikkö",
      "remarkSource": "Ulosottovirasto",
      "remarkCode": "UMV",
      "caseTypeCode": "MUU",
      "remarkType": "PaymentRemark",
      "remarkDate": "2014-07-15T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": "2018-07-15T00:00:00Z",
      "remarkExpiresDate": "2018-07-15T00:00:00Z",
      "incidentId": null
    },
    {
      "remarkId": 10927702,
      "amount": 12513,
      "caseId": null,
      "additionalInfo": null,
      "creditor": null,
      "remarkSource": "Ulosottovirasto",
      "remarkCode": "UMP",
      "caseTypeCode": "MUU",
      "remarkType": "PaymentRemark",
      "remarkDate": "2014-08-11T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": "2018-08-11T00:00:00Z",
      "remarkExpiresDate": "2018-08-11T00:00:00Z",
      "incidentId": "55326"
    },
    {
      "remarkId": 10927700,
      "amount": 552,
      "caseId": null,
      "additionalInfo": null,
      "creditor": "Helslingin kaupunki",
      "remarkSource": "Ulosottovirasto",
      "remarkCode": "UMS",
      "caseTypeCode": "MUU",
      "remarkType": "PaymentRemark",
      "remarkDate": "2014-10-20T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": "2018-10-20T00:00:00Z",
      "remarkExpiresDate": "2018-10-20T00:00:00Z",
      "incidentId": null
    },
    {
      "remarkId": 1506910,
      "amount": 0,
      "caseId": null,
      "additionalInfo": "Vakuusvelka",
      "creditor": null,
      "remarkSource": "Oikeusrekisterikeskus",
      "remarkCode": "HVP",
      "caseTypeCode": "MUU",
      "remarkType": "OtherRemark",
      "remarkDate": "2008-10-22T00:00:00Z",
      "remarkPaidDate": null,
      "remarkValidToDate": "2018-12-31T00:00:00Z",
      "remarkExpiresDate": "2018-12-31T00:00:00Z",
      "incidentId": "126557"
    }
  ]
}

Swagger documentation - read more! »