Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/attachments/[id]

Various, depending on data type

Write

MDM T02/document
ORU R01/radiology

 

 

Various, depending on data type

Attributes

Public ID

String

The ID of the attachment.

 

 

 

 

Filename

String

The filename of the attachment.

OBX-3.2 (ORU R01/radiology)
OBX-3.5 (ORU R01/radiology)
TXA-16.1 (MDM T02/document)

 

 

Various, depending on data type

Content

Binary

The content of the attachment.

OBX-5.5 (ORU R01/radiology)
OBX-5.5 (MDM T02/document)

 

Returned in the download stream

Various, depending on data type

Media Type

String

The type of media contained in the content.

OBX-5.3 (ORU R01/radiology)

 

 

 

...

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

QRY A19

/Patient

/users/self
/users/myCarers
/users/myPatients
/v1/users/[userId]
/v1/users/self/patients
/v2-beta/users/byNationalId/[nationalId]/[nationalIdType]

Profile
Sharing

Write

ADT A28
ADT A31

/Patient/$process-message

/v1/users

Profile
Add carer

Attributes

Middle Names

String

Any middle names of the patient.

PID-5.3

Patient.name

 

Profile page

Address Line 1

String

First line of the address.

PID-11.1

Patient.address

 

Profile page

Address Line 2

String

Second line of the address.

PID-11.2

Patient.address

 

Profile page

City

String

The nearest city or town.

PID-11.3

Patient.address

 

Profile page

State

String

The state.

PID-11.4

Patient.address

 

Profile page

Country

String

The country.

PID-11.6

Patient.address

 

Profile page

Postal Code

String

The postal code.

PID-11.5

Patient.address

 

Profile page

Date of Birth

Local Date

Date of birth.

PID-7.1

Patient.birthDate

 

Profile page

Death Timestamp

Timestamp

When the patient died.

PID-29.1

Patient.deceased

 

 

Gender

Enum

This is the administrative gender of the patient.

  • UNKNOWN

  • MALE

  • FEMALE

  • INDETERMINATE

PID-8.1

Patient.gender

 

Profile page

Language

Enum

The primary language of the patient.

PID-15.1
PID-15.4

 

 

Language dropdown shown in the footer of every page.

Time Zone

Enum

The patient's current preferred time zone. This will be used to localise times within the web interface.

 

 

 

Profile page

Skype ID

String

How to contact the patient on Skype.

 

 

 

Profile page

Phone

String

The phone number of the patient.

PID-13.1
PID-14.1

Patient.telecom

 

Profile page

Status

Enum

The status of the patient.

PID-30.1

 

 

 

Registered

Boolean

Whether or not the patient has registered with PKB. If a patient is registered, they have the ability to log into their account.

 

 

 

 

Sharing Disabled

Boolean

Whether or not the patient has requested Sharing Disabled.

 

sharing-disabled

 

 

Access Frozen

Boolean

Whether or not access to this medical record has been frozen.

 

 

 

 

Entered Timestamp

Timestamp

Flexibly used, depending on the type of data. It is broadly intended to capture the timestamp when the information was entered into the originating system.

MSH-7

 

 

 

Persisted Timestamp

Timestamp

The timestamp when the information was persisted in PKB.

 

 

 

 

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

/Consent

/v1/consents/byPatient/[patientId]

Sharing

Write

 

 

/v1/consents/forPatient/[patientId]

Sharing

Attributes

Public ID

String

An ID for this Consent Record.

 

Consent.id

 

 

General Health Granted

Boolean

Whether or not the patient has granted access to the general health portion of their medical record.

 

Consent.except

 

 Sharing

Mental Health Granted

Boolean

Whether or not the patient has granted access to the mental health portion of their medical record.

 

Consent.except

 

 Sharing

Sexual Health Granted

Boolean

Whether or not the patient has granted access to the sexual health portion of their medical record.

 

Consent.except

 

 Sharing

Social Care Granted

Boolean

Whether or not the patient has granted access to the social care portion of their medical record.

 

Consent.except

 

 Sharing

Reason Code

Enum

  • MIGRATED

  • CREATED_ACCOUNT

  • REFERRAL

  • POWER_OF_ATTORNEY

  • COURT_ORDER

  • EXPLICIT_CONSENT

  • DISCHARGE

  • SAFEGUARDING

  • PATIENT_OPT_OUT

 

 

 

 

Reason Text

String

A description justifying why these consent values were set.

 

 

 

 

Discharged

Boolean

Indicates whether the actor is currently providing care to the patient.

 

Consent.status

 

 Sharing

Identifiers

Class Diagram

Identifiers

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/v2-beta/allergies/forPatient/[patientId]

Allergies

Write

ADT A28
ADT A31

 

 

Allergies

Attributes

Allergen

CodeableConcept

The allergen.

AL1-3

 

ApiAllergy.substanceCode

Allergy listing page
Allergy details page

Onset Timestamp

Timestamp

When the symptoms began.

AL1-6.1

 

ApiAllergy.onsetOfSymptoms

Allergy listing page
Allergy details page

Reactions

CodeableConcept List

The reactions to the allergen.

AL1-5.1

 

ApiAllergy.reactions

Allergy listing page
Allergy details page

Severity

CodeableConcept

How severe the reaction to the allergen is.

AL1-4

 

ApiAllergy.severity

Allergy listing page
Allergy details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

/Appointment

 

Appointments

Write

SIU S12  /S13  /S14  /S15  /S26
ADT A05  /A14  /A27  /A38

 

 

Appointments

Attributes

Type

Coding

The type of appointment.

SCH-8
ZSC-8

 

 

Appointment details page

Start Timestamp

Timestamp

When the appointment starts.

SCH-11.4
EVN-3.1 (ADT)
PV1-44.1 (ADT)
PV2-8.1 (ADT)

Appointment.start

 

Appointment listing page
Appointment details page

End Timestamp

Timestamp

When the appointment ends.

SCH-11.5

Appointment.end

 

Appointment details page

Subject

String

A brief reason for the appointment.

SCH-7.2
PV1-2.1 (ADT)

Appointment.reason

 

Appointment listings page
Appointment details page

Description

String

A longer explanation of the appointment.

NTE-3.1 (SIU)

Appointment.comment

 

Appointment details page

Location

String

Where the appointment is to be held.

PV1-3.9 (SIU)
PV1-3.9 (ADT)

Appointment.participant

 

Appointment details page

Status

Enum

  • ACTIVE

  • CANCELLED

  • DNA

SIU

Appointment.status

 

Appointment listings page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/v2-beta/careplans/[patientId]
/treatmentPlans/forPatient/[id]
/v1/treatmentPlans/mine

Plans

Write

MDM T02/care plan

 

/v1/treatmentPlans

Plans

Attributes

Name

String

The name of the care plan.

OBX-3.2 (MDM T02/care plan)
OBX-3.5 (MDM T02/care plan)

 

 

Care plan listing page
Care plan details page

Created Timestamp

Timestamp

The timestamp when the care plan was first created.

TXA-4.1 (MDM T02/care plan)

 

 

Care plan listing page
Care plan details page

Last Edited Timestamp

Timestamp

The timestamp when the care plan was last edited.

TXA-4.1 (MDM T02/care plan)

 

 

Care plan listing page
Care plan details page

Action Plan

String or Binary

The main body of the care plan. This can be plaintext, HTML or a PDF file.

OBX-5.5 (MDM T02/care plan)

 

 

Care plan details page

Green

String

An explanation of what to expect when the condition is under control.

 

 

 

Care plan details page

Amber

String

An explanation of what might need attention.

 

 

 

Care plan details page

Red

String

An explanation of what needs urgent attention.

 

 

 

Care plan details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/v2-beta/diagnoses/forPatient/[patientId]

Diagnoses

Write

ADT A28
ADT A31

 

 

Diagnoses

Attributes

Diagnosis

CodeableConcept

The diagnosis.

DG1-3

 

ApiDiagnosis.diagnosis

Diagnosis listing page
Diagnosis details page

Start Timestamp

Timestamp

When the condition began.

DG1-5.1

 

ApiDiagnosis.startDate

Diagnosis listing page
Diagnosis details page

End Timestamp

Timestamp

When the condition ended.

 

 

ApiDiagnosis.endDate

Diagnosis listing page
Diagnosis details page

Details

String

Additional information about this diagnosis.

 

 

ApiDiagnosis.details

Diagnosis details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

/DocumentReference

 

Events & messages

Write

MDM T02/document

 

 

 

Attributes

Class

Enum

  • IN_PATIENT

  • OUT_PATIENT

  • AMBULATORY

  • EMERGENCY

  • HOME

  • FIELD

  • DAYTIME

  • VIRTUAL

  • OTHER

PV1-2.1 (MDM T02/document)

 

 

Inbox page
Conversation page

Timestamp

Timestamp

The document timestamp.

TXA-8,7,6,4

DocumentReference.created

 

Conversation page

Document Type

Enum

  • ADMISSION_TCI_LETTER

  • ALERT_NOTIFICATION

  • APPOINTMENT_LETTER

  • BIRTH_REPORT

  • CLINIC_LETTER

  • DISCHARGE_LETTER

  • DISCHARGE_SUMMARY

  • MULTI_DISCIPLINARY_TEAM_MEETING_NOTES

  • REFERRAL_LETTER

TXA-2.1 (MDM T02/document)

DocumentReference.type

 

 

Status

Enum

  • READ

  • UNREAD

 

document-status
search param: document-status

 

 

Planned Postal Date

Timestamp

When this document would need to be posted. This field forms part of the Mail Management workflow.

ZPM-1

 

 

 

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

 

Journal

Write

 

 

/v1/journal

Journal

Attributes

Subject

String

What the entry is about.

 

 

 

 

Entry

String

The content of the entry.

 

 

 

 

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

/Observation

/v1/tests/results/forPatient/byTestIds
/v2-beta/tests/results

Tests

Write

ORU R01/lab

 

 

Tests

Attributes

Service

String

The overarching service of the lab results.

OBR-4.2 (ORU R01/lab)
OBR-4.5 (ORU R01/lab)

 

 

Lab result listings page

Test Code

String

The code of the test that was performed.

This captures the raw value as provided by the input source, for example from an HL7 message. It is not populated when the user enters a result directly into the PKB web UI, which asks them to select a type from a dropdown.

OBR-4.1 (ORU R01/lab:textual)
OBX-3.1 (ORU R01/lab)

 

 

 

Test Coding System

String

The coding system of the test that was performed.

This captures the raw value as provided by the input source, for example from an HL7 message. It is not populated when the user enters a result directly into the PKB web UI, which asks them to select a type from a dropdown.

OBR-4.3 (ORU R01/lab:textual)
OBX-3.3 (ORU R01/lab)

 

 

 

Timestamp

Timestamp

The clinically relevant timestamp of the lab result.

OBR-7.1 (ORU R01/lab)
OBX-14.1 (ORU R01/lab)

Observation.effectiveDateTime

 

Lab result details page

Value

Number

The result value.

This will not always be populated. If the result does not parse as a number, or if numeric values are not valid for this test type, then Value Text will be populated instead. Alternatively, if an HL7 message contained the single textual report content pattern, then the text of that report will be populated in the Comments attribute, rather than the Value.

OBX-5.1 (ORU R01/lab)

 

 

Lab results details page

Value Text

String

The textual result value.

This will not always be populated. If a numeric Value has been assigned then the textual representation is not stored.

OBX-5.1 (ORU R01/lab)

 

 

Lab results details page

Comments

String

Any comments associated with the lab result.

NTE-3.1 (ORU R01/lab)
OBX-5.1 (ORU R01/lab)

 

 

Lab result details page

Range Low

Number

The lowest expected value for this lab result.

OBX-7.1 (ORU R01/lab)

 

 

Lab result details page

Range Low Inclusive

Boolean

Whether or not the Range Low value is inclusive.

OBX-7.1 (ORU R01/lab)

 

 

 

Range High

Number

The highest expected value for this lab result.

OBX-7.1 (ORU R01/lab)

 

 

Lab result details page

Range High Inclusive

Boolean

Whether or not the Range High value is inclusive.

OBX-7.1 (ORU R01/lab)

 

 

 

Textual Range

String

A textual range is used to indicate the expected outcome for a non-numeric test result.

OBX-7.1 (ORU R01/lab)

 

 

Lab results details page

Comparator

Enum

  • GREATER_OR_EQUAL

  • LESS_OR_EQUAL

  • GREATER

  • LESS

OBX-5.1 (ORU R01/lab)

 

 

Lab results details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

 

 

Write

ORU R01/lab

 

 

 

Attributes

ID

Number

An ID for this Local Test Type.

 

 

 

 

Source Organisation

Ref : [[Organisation.Public ID]]

The organisation which sent this lab result.

 

 

 

 

Test Code

String

The test code.

 

 

 

 

Test Coding System

String

The coding system from which the test code was drawn.

 

 

 

 

Units

String

The units for the test.

 

 

 

 

Test Name

String

The display name provided for the most recently received test result of this type.

 

 

 

 

Service Name

String

The display name provided for the service (a.k.a. panel) which contained the most recently received test result of this type.

 

 

 

 

Expected Value Type

Enum

  • TEXT

  • POSNEG

  • NUMERIC

  • VARIES

 

 

 

 

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/v2-beta/measurements/[patientId]
/v2-beta/measurements

Measurements

Write

ORU R01/lab

 

/v1/measurements
/v1/measurements/[measurementId]
/v2-beta/measurements/[patientId]

Measurements

Attributes

Name

String

The name of the type of measurement.

 

 

 

 

Code System

String

The code system used.

 

 

 

Measurement listing page
Measurement details page

Code of Whole

String

The code representing the overall measurement.

 

 

 

 

Code

String

The code of the first value, if this is a multi-valued measurement.

 

 

 

 

Code2

String

The code of the second value, if this is a multi-valued measurement.

 

 

 

 

Unit

String

The units of the value.

 

 

 

Measurement listing page
Measurement details page

Unit2

String

The units of the second value.

 

 

 

 

Timestamp

Timestamp

The timestamp when the measurement was taken.

OBR-7.1 (ORU R01/lab)
OBX-14.1 (ORU R01/lab)

 

 

Measurement details page

Value

Number

The value of the measurement.

OBX-5.1 (ORU R01/lab)

 

 

Measurement listing page
Measurement details page

Value2

Number

The second value, if relevant. This is intended to allow two related measurements to be grouped together, e.g.diastolic and systolic blood pressure. This is not a second reading of the first value.

OBX-5.1 (ORU R01/lab)

 

 

Measurement listing page
Measurement details page

Value Non-Numeric

String

The value of the measurement if it is not numeric.

 

 

 

Measurement listing page
Measurement details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/v1/medications
/v1/medications/active
/v1/medications/forPatient/[patientId]/active
/v1/medications/forPatient/[patientId]

Medicines

Write

ADT A28
ADT A31

 

/v1/medications

Medicines

Attributes

Status

Enum

  • ACTIVE

  • INACTIVE

 

 

 

 

Substance

CodeableConcept

The medication.

ZRX-2

 

 

Medication listing page
Medication details page

Start Timestamp

Timestamp

When the medication was started.

ZRX-1.4

 

 

Medication listing page
Medication details page

End Timestamp

Timestamp

When the medication was finished.

ZRX-1.5

 

 

Medication listing page
Medication details page

Frequency Text

String

How frequently the medication should be taken.

ZRX-1.2

 

 

Medication listing page
Medication details page

Frequency Value

Number

A representation of how frequently the medication should be taken, when combined with Frequency Units.

 

 

 

Frequency Units

Enum

  • HOUR

 

 

 

 

Frequency Priority

Enum

Can be used to capture a frequency instruction of:

  • AS_DIRECTED

  • AS_NEEDED

 

 

 

 

Dose Value

Number

How much should be taken.

ZRX-3.1

 

 

Medication listing page
Medication details page

Dose Units

CodeableConcept

The units of the Dose Value.

ZRX-5

 

 

Medication listing page
Medication details page

Instructions

String

How to take the medication.

ZRX-7.2

 

 

Medication listing page
Medication details page

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

/DiagnosticReport

 

Imaging

Write

OBR-7.1 (ORU R01/radiology)

 

 

Imaging

Attributes

Timestamp

Timestamp

The clinically relevant timestamp of the report.

OBR-7.1 (ORU R01/radiology)

DiagnosticReport.effectiveDateTime

 

Radiology report listing page
Radiology report details page

Title

String

A title for the report.

OBR-4.2 (ORU R01/radiology)
OBR-4.5 (ORU R01/radiology)

 

 

Radiology report listing page
Radiology report details page

Description

String

The report contents.

NTE-3.1 (ORU R01/radiology)
OBX-5.1 (ORU R01/radiology)

 

 

Radiology report details page

Enterer Location

String

A description of the location of the person who entered the request.

ORC-13.9 (ORU R01)

 

 

 

...

 

HL7 API

FHIR API

REST API

Web (Patient)

Summary of interactions

Read

 

 

/symptomReports/all
/v1/symptoms/monitored
/v1/symptoms/reports/after/[timestamp]
/v1/symptoms/reports/forPatient/bySymptoms

Symptoms

Write

 

 

/v1/symptoms/reports

Symptoms

Attributes

Symptom

CodeableConcept

The symptom which is being reported.

 

 

 

 

Timestamp

Timestamp

Timestamp for the symptom report.

 

 

 

 

Severity

Enum

  • NONE

  • MILD

  • MODERATE

  • SEVERE

 

 

 

 

...