For software developers

On this page, we have collected information and instructions on the register’s APIs and on stakeholder testing:

  • Documentation: this page contains technical instruction documents, such as API descriptions
  • Stakeholder testing: this page contains instructions on stakeholder testing
  • Certificate: this page contains information on certificates needed for the use of APIs.

In addition to technical instructions, also read important instructions for filing and requesting data: 

Technical APIs and their use

The users of the register, i.e. the data notifiers and data users, communicate through APIs. A technical API is an access point created in accordance with certain specifications and used for sending information between external parties and the register. The register's APIs are REST interfaces with JSON data content.

To access APIs, the user needs a certificate issued by the Tax Administration. The certificate identifies the organisation using the API and ensures data integrity. Further information on the certificate and its retrieval is available on the Certificate page. Different certificates are needed for the production environment and the testing environment.

APIs for reporting data, and their addresses

The APIs for reporting data that are available to lenders are listed below. To use these APIs, the lender needs a certificate for reporting data.

New loans: https://api.positiivinenluottotietorekisteri.fi/AddLoans

Changes to loans: https://api.positiivinenluottotietorekisteri.fi/UpdateLoans

Payment transactions: https://api.positiivinenluottotietorekisteri.fi/Repayments

Delayed amounts: https://api.positiivinenluottotietorekisteri.fi/DelayedRepayments

End of loan contract: https://api.positiivinenluottotietorekisteri.fi/TerminateLoans

Batch status inquiry: https://api.positiivinenluottotietorekisteri.fi/GetBatchStatus

Checking loan data: https://api.positiivinenluottotietorekisteri.fi/GetLoan

API for requesting data

Lenders can use the API below to request data. To access the API, lenders need a certificate for requesting data.

Requesting credit register extracts: https://api.positiivinenluottotietorekisteri.fi/GetCreditRegisterExtract

Page last updated 12/7/2022