Skip to content

Access Patient Information

The FHIR Patient API gives you access to patient's information and their care pathways.

Access Control

You have to use the Access Token of an authenticated user with the PATIENT_READ permission in the scope to access the FHIR Patient API. For user authentication, take a look at the Connect Users Guide.

With the Lifen Connect Pro, access only to patients for whom the user is the referring physician.

With the Lifen Connect Patient, access only to patients associated with your account. There is one FHIR Patient resource per doctor that follows the user.

Patient administrative data

The FHIR Patient resource contains the following patient administrative data:

  • name
  • birthdate
  • telecom: a list of dematerialized communication channels with the patient (mail and/or phone)
  • address: his postal address
  • identifier: A list of national or institutional identifiers that can be associated with it (e.g. NIR, INS, IPP, etc.).
  • generalPractitioner: The referring physician to whom the latter is attached.

To better understand the FHIR standard definition of each field, you can refer to the FHIR documentation here : FHIR Patient DSTU3.

Patient's hospitalization

A patient can be hospitalized and stay in a hospital in different departments. Stays are represented by the FHIR resource Encounter.

An Encounter has several fields too :

  • period: The start and end time of the encounter (search on a range but not on specific field start or end (more details here)
  • subject: The patient present at the encounter
  • service-provider._extension: Search on UF (Functional Unit) extension to filter on healthcare service

Some example to search on Encounter :

  • /Encounter?date=ge2021-01-01
  • /Encounter?patient=Patient/12345
  • /Encounter?service-provider._extension=|500

To learn more about the definitions of the other fields, you can look at the definition of the fields here : FHIR Encounter DSTU3