Individual citizens can enter information about their wellbeing in the My Kanta Personal Health Record (Kanta PHR) using wellbeing applications and devices developed for such purpose. The pages with wellbeing-related content offer additional information about the service and a selection of latest news.
Anyone can develop a new wellbeing application that utilises Kanta PHR. Both server based and mobile applications are possible. The users can be citizens, professionals or both.
Kanta PHR provides developers with the necessary interfaces and an approved open-access national data content, both of which are based on the HL7 FHIR standard. FHIR Rest API interfaces are defined in the Capability Statement. The data content is being developed in cooperation with various actors.
Developers can already now integrate their application with the Kanta PHR sandbox environment for self-testing. Prior to integration with the Kanta PHR production environment, applications must meet a set of national approval criteria for wellbeing applications and pass joint testing.
By integrating with Kanta PHR, which is free of charge, developers can raise awareness of their service by associating it with the Kanta Services. Kanta PHR data are available to applications and can be used as a basis for developing new services.
Once the service has been launched, citizens will have the option of sharing their Kanta PHR data with social welfare and healthcare professionals. The criteria for applications targeting professional users cannot be finalized until the new Client Data Act has entered into force. The relevant bill is currently under review in Parliament.
At the moment, Kanta PHR can only be used by persons who are 16 years of age or older. This requirement may be revised once the new Act has entered into force.
The glossary of terms describes briefly the terminology and concepts related to Kanta PHR. The descriptions have been formulated specifically to fit the context of Kanta PHR and wellbeing applications. Concepts and terms associated with Kanta PHR are also defined in the list of Kanta terminology compiled by the Finnish Institute for Health and Welfare (in Finnish).
Wellbeing applications integrated with Kanta PHR must conform to prevailing laws, decrees and statutes.
- Read instructions for using simultaneous STU3 and R4 endpoints Finnish PHR support for STU3 & R4 (pdf).
- Kanta PHR is moving to the FHIR R4 version. Therefore, production will no longer deploy new profiles of the FHIR STU3 version, and it is no longer recommended to join Kanta PHR with the STU3 version application. All new data contents entered must be in the FHIR R4 format and in accordance with the FHIR R4 profiles of Kanta PHR. In Sandbox, you can start testing the platform R4 support with the FHIR R4 profiles published in Simplifier in the Finnish PHR R4 project. Their status shown in Simplifier is "Accepted". The number of tested profiles will grow as and when R4 support for them will be completed. We will notify separately when it will be possible to register for joint testing with FHIR R4 profiles.
- Due to the delay in the progress of the Client Data Act and the related financing decisions, the development of the data content of Kanta PHR has been temporarily suspended. The development will be continued as soon as it is possible.
- Presentation of Kanta PHR for application suppliers (pdf)
- General description (DRAFT): National PHR and management of wellbeing information (pdf, in Finnish)
- HL7 FHIR standard (hl7.org)
- The Finnish PHR profiling guidelines (pdf)
- Capability statement (simplifier.net)
- The implementation guide (simplifier.net)
- Authorization guide for the sandbox environment (pdf)
- PHR authorization guide (pdf)
- OAuth 2.0 protocol (oauth.net)
- Approval criteria form (xls)
- Application form (xls, in Finnish)