My Kanta Pages PHR

My Kanta Pages PHR

PHR is a national data repository in which citizens may enter information on their health and wellbeing.

My Kanta Pages Personal Health Record (Kanta PHR) is a My Kanta Pages service currently under development as part of the Kanta services. The production deployment of the first phase of PHR will take place in the spring 2018, when pilot applications has been integrated to Kanta PHR.

PHR is a national data repository in which citizens may enter information on their health and wellbeing. Health and wellbeing information refers to the citizens’ measurement, lifestyle and activity records directly or indirectly related to their wellbeing and promoting their health. Using the service is voluntary.

Kela is producing the Kanta PHR platform and will maintain and develop it. Kela is also acting as the register controller of Kanta PHR.

Current issues

  • Tuesday 19.6.2018 12:30-15:00 is HL7 Finland PH SIG Kanta PHR support meeting where proposals for changing or expanding the current Kanta PHR data content are discussed and you can get some technical advises about integration to Kanta PHR. More information (in Finnish):
  • 29.5.2018: Kela's PHR team will participate in the Upgraded Life Festival 2018 event, which is 31.5. - 1.6.2018 at Helsinki. Please come and meet us at our stand!
  • 22.5.2018: The first production deployment phase of Kanta PHR has started in 23.4.2018. Terveyskylä's Omapolku application, which is made by Virtuaalisairaala 2.0-program, has been integrated to Kanta PHR and pilot users are saving their wellbeing data (daily activity, steps taken, weight) into Kanta PHR via Terveyskylä’s Omapolku-application. Pilot users can see their wellbeing data in My Kanta Pages-service and Terveyskylä's Omapolku service. In this pilot phase, Kanta PHR is available only for known pilot users. The pilot is going to have more users in autumn.
  • Tuesday 15.5.2018 12:30-15:00 is HL7 Finland PH SIG Kanta PHR support meeting. Eeva Turkka continues to advice how to use Kanta PHR Sandbox-environments and tells about Oauth 2.0 authorization. In addition, proposals for changing or expanding the current Kanta PHR data content are discussed and reviewed. More information (in Finnish):

Using Kanta PHR with wellbeing applications

Citizens may enter and manage their wellbeing information using wellbeing applications and measuring devices developed for the purpose in Kanta PHR. For wellbeing application suppliers, Kanta PHR offers the open national authorised data content which is based on HL7 FHIR standard. Suitable records for authorised data content are e.g. various measurement information (blood pressure, respiration rate), symptom assessments, check-ups and self-treatment plans. The data content will be developed jointly with HL7 Finland Personal Health SIG group.

The wellbeing applications (web or mobile applications) to be integrated in Kanta PHR will be created through national projects, produced by private organisations, or to order by social and healthcare service providers. Citizens install or deploy the application in accordance with instructions provided by the supplier. At the time of deployment, the citizen gives the application consent to process his wellbeing information entered in Kanta PHR in the way described by the application. The applications must be authorised by the Kanta Services. Kela maintains a list of applications authorised for Kanta PHR. The list will be published at a later date.

Functionalities for social and healthcare professionals

In order for a social and healthcare service provider to access a citizen’s PHRs, the service provider must have a professional application authorised for PHR for the purpose, as well as the citizen’s consent and a treatment relationship. A professional application is a certified (Class A social and healthcare data systems) separate application or part of a healthcare information system.

Functionalities for the citizen in My Kanta Pages

The citizen may manage, access and delete the data in PHR via My Kanta Pages.

Citizens may give their consent in My Kanta Pages to social and healthcare service providers for the use of the entered data in support of decisions concerning their health and wellbeing, as well as an aid for diagnostic purposes. For this purpose a healthcare service provider must have a professional application authorized for PHR and a treatment relationship with the customer. The citizen has the right to refuse to give the consent. The citizen can maintain his / hers consents and refusals via My Kanta Pages and withdraw those at any time.

In My Kanta Pages, citizens can see a list of applications to which they have given permission to access PHR and, if they so wish, they can withdraw the permission for the application to process their data in PHR.

For application suppliers

For application suppliers, PHR offers an FHIR interface and an open accepted national data content. Information to be recorded in accordance with the accepted data content includes various measurement data (e.g. blood pressure, respiration rate), symptom evaluations, examinations and self-care plans.

HL7 FHIR and the national data content

Kanta PHR and its data content are based on the HL7 FHIR standard. The data content is developed in cooperation with the HL7 Finland Personal Health SIG group. The materials are available in English.

The use of the HL7 FHIR standard in PHR is described in the Implementation Guide document. The guide is meant for those carrying out definition and development work and who need information about the FHIR resources, elements and expansions utilised in PHR.

The PHR platform supports only the JSON format, and therefore all resources (including profiles, etc.) must be recorded on the platform in JSON format.

Reference to the FHIR profile and conformity with the profile are mandatory

Reference to and conformity with the profile that is part of the national data content of PHR are mandatory. The server validates the contents of the resource to be recorded against the profile referred in it, and it will reject a resource if its contents do not conform to the profile.

Reference to the profile is made by entering the following in the profile’s URL resource metadata:

"resourceType": "Patient",
"meta": {
      "profile": [


The PHR platform utilises the OAuth 2.0 authorisation protocol in the authorisation process.

The PHR authorisation guide describes the authorisation profiles and flows used with the platform. The guide contains references to the applicable OAuth 2.0 definitions.

Integrating an application with PHR

Applications to be integrated with PHR must meet the national approval criteria and they must pass the approval testing stage. Applications aimed at professional use must also pass Kanta certification (class A).

Before the approval testing of the application, the application supplier must become acquainted with the national data content and test the application in the Sandbox environment provided by the Kanta services.  If the national data content does not contain the resources or profiles required by the application, the necessary additions/changes must be approved in accordance with the data content development process.

An outline of the staging of the integration of wellbeing applications aimed at citizens is presented in the following graph (click to enlarge). Read more about integrating an application with PHR.

Graph: Integrating an application with PHR

In the first stage of the PHR service, the applications are not able to utilise client data (Patient Data Repository and Prescription) because this requires amendments to the Client Data Act. The legislative amendments will be debated in Parliament during 2018. More client instructions will be added to the website as the work progresses.

The interface and data content definitions and the support material for application developers are published in English on the website.

There is an open Finnish PHR communication chat tool that provides support for application developers who can post and comment questions related to PHR. The preferred communication language in the chat service is English. Kela monitors the service and answers questions on a weekly basis. It is also possible to receive further information by email at kantakehitys(at)

Read more

Last updated 18.06.2018