Upcoming changes
The register is being developed on a continuous basis. On this page, we provide technical documentation regarding upcoming changes.
You can find the documentation relating to the currently used system, i.e. the production documentation, on the Production documentation page.
API descriptions
API descriptions describe the data content to be reported, the structure of the messages to be sent to the API and of the response messages returned from the API.
The changes to be released to the API on 1 April 2027 are described in version 2.3 of the description of the API for requesting a credit register extract. The changes have to do with how data about a person’s apartment-specific credit liabilities, received from the Residential and Commercial Property Information System of the National Land Survey of Finland, is presented on the credit register extract.
- Requesting a credit register extract – API description (pdf) version 2.3. Published on 1 September 2026.
Message examples
Version 2.2 of Message examples includes examples of how the API changes to be released on 1 April 2027 will affect the response messages of the API for requesting a credit register extract. A description of the content of the message examples is provided in a separate document.
- Message example content (pdf) version 2.2. Published on 1 September 2026.
The Message examples file (zip) contains earlier released examples supplemented with summary data relating to apartment-specific credit liabilities, and three new message examples describing the API changes to be released on 1 April 2027.
- Message examples (zip) version 2.2. Published on 1 September 2026.
Schema descriptions
Schema descriptions describe the structure and content of the messages, and the simplest requiredness rules. The schema description of the API for requesting a credit register extract will change on 1 April 2027 when data about apartment-specific credit liabilities will be added to the data content of the extract. You can find a detailed description of the changes in the API descriptions. The schema descriptions are listed and the changes described in a separate document.
- Schema description content (pdf) version 1.0. Published on 1 September 2026.
The Schema descriptions file (zip) contains only schema descriptions relating to the changes to be introduced on 1 April 2027.
- Schema descriptions (zip) version 1.0. Published on 1 September 2026.