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 element | Description |
|---|---|
| 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
| Parameter | Description | |
|---|---|---|
| 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 |
| urser | The name of the person (end user) who made the request. e.g. John Doe | |
| X = Mandatory, * = Only in the credit check use | ||
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"
}
]
}