Added

April 6, 2026: New tables and columns added to Zus data mart relational schema

New tables and columns are now available to customers in Zus data marts as of April 6th, 2026.

These additions reduce the number of joins required when querying specific tables, enabling simpler and faster queries.

Changes include:

  • Simplifying access to identifier values - Previously, to access identifier information on a specific FHIR resource, users would need to join the primary FHIR resource table (e.g. PATIENT) with a bridge table (e.g. PATIENT_IDENTIFIER) before joining with the IDENTIFIER table to retrieve the identifier value. With these changes, users will no longer need to join with the IDENTIFIER table as the identifier values have been added to the bridge tables (PATIENT_IDENTIFIER, APPOINTMENT_IDENTIFIER, CONDITION_IDENTIFIER, etc.) directly.
  • Simplifying access to contact information - Previously, to access contact information for a specific FHIR resource, users would need to join the primary FHIR resource table (e.g. PATIENT) with a bridge table (e.g. PATIENT_TELECOM) before joining with the CONTACT_POINT table to retrieve the contact information. With these changes, users will no longer need to join with the CONTACT_POINT table as the contact information has been added to the telecom tables (PATIENT_TELECOM,RELATED_PERSON_TELECOM, etc.) directly.

The full set of changes are described below. We have updated our data dictionary to reflect these changes and will likewise update our schema diagrams in the coming days.

Summary of changes

New or existing TableTable NameNew Columns
ExistingALLERGY_INTOLERANCE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingAPPOINTMENT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingCARE_PLAN_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingCARE_TEAM_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingCARE_TEAM_TELECOMsystem, value, use, rank, period_start, period_end
ExistingCONDITION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingCONSENT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingCOVERAGE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingDEVICE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingDEVICE_USE_STATEMENT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingDIAGNOSTIC_REPORT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingDOCUMENT_REFERENCEmaster_identifier_system, master_identifier_value, master_identifier_use, master_identifier_assigner_display
ExistingDOCUMENT_REFERENCE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingENCOUNTER_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingFAMILY_MEMBER_HISTORY_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingGOAL_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingIMMUNIZATION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingLENS_ENCOUNTER_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingLENS_TRANSITION_OF_CARE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingLOCATION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingLOCATION_TELECOMsystem, value, use, rank, period_start, period_end
ExistingMEDICATION_ADMINISTRATION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingMEDICATION_DISPENSE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingMEDICATION_REQUEST_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingMEDICATION_STATEMENT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingOBSERVATION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingORGANIZATION_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingORGANIZATION_TELECOMsystem, value, use, rank, period_start, period_end
ExistingPATIENT_CONTACT_TELECOMsystem, value, use, rank, period_start, period_end
ExistingPATIENT_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingPATIENT_NAMEdisplay, family, given_1, given_2, prefix_1, suffix_1, period_start, period_end
ExistingPATIENT_TELECOMsystem, value, use, rank, period_start, period_end
ExistingPRACTITIONER_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingPROCEDURE_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingRELATED_PERSON_IDENTIFIERsystem, value, use, type_display, assigner_display
ExistingRELATED_PERSON_TELECOMsystem, value, use, rank, period_start, period_end
NewDEVICE_USE_STATEMENT_BODY_SITEid, display
NewDEVICE_USE_STATEMENT_BODY_SITE_CODINGdevice_use_statement_body_site_id, system, code, display
NewIMMUNIZATION_BODY_SITEid, display
NewIMMUNIZATION_BODY_SITE_CODINGimmunization_body_site_id, system, code, display
NewIMMUNIZATION_ROUTEid, display
NewIMMUNIZATION_ROUTE_CODINGimmunization_route_id, system, code, display
NewLENS_RXNORM_MEDICATION_STATEMENT_DOSAGEid, display, timing_repeat_period_unit, timing_repeat_bounds_start, timing_repeat_bounds_end, timing_period, lens_rxnorm_medication_statement_dosage_route_id, lens_rxnorm_medication_statement_dosage_method_id, additional_instruction_display, dose_quantity_unit, dose_quantity_value
NewLENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_METHODid, display
NewLENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_METHOD_CODINGlens_rxnorm_medication_statement_dosage_method_id, system, code, display
NewLENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_ROUTEid, display
NewLENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_ROUTE_CODINGlens_rxnorm_medication_statement_dosage_route_id, system, code, display
NewLENS_RXNORM_MEDICATION_STATEMENT_MEDICATION_CODEid, display
NewLENS_RXNORM_MEDICATION_STATEMENT_MEDICATION_CODE_CODINGlens_rxnorm_medication_statement_medication_code_id, system, code, display, is_active_ingredient
NewMEDICATION_ADMINISTRATION_DOSAGE_ROUTEid, display
NewMEDICATION_ADMINISTRATION_DOSAGE_ROUTE_CODINGmedication_administration_dosage_route_id, system, code, display
NewMEDICATION_ADMINISTRATION_MEDICATION_CODEid, display
NewMEDICATION_ADMINISTRATION_MEDICATION_CODE_CODINGmedication_administration_medication_code_id, system, code, display, is_active_ingredient
NewMEDICATION_CODEid, display
NewMEDICATION_CODE_CODINGmedication_code_id, system, code, display, is_active_ingredient
NewMEDICATION_DISPENSE_MEDICATION_CODEid, display
NewMEDICATION_DISPENSE_MEDICATION_CODE_CODINGmedication_dispense_medication_code_id, system, code, display, is_active_ingredient
NewMEDICATION_REQUEST_DOSAGEid, display, timing_repeat_period_unit, timing_repeat_bounds_start, timing_repeat_bounds_end, timing_period, medication_request_dosage_route_id, medication_request_dosage_method_id, additional_instruction_display, dose_quantity_unit, dose_quantity_value
NewMEDICATION_REQUEST_DOSAGE_METHODid, display
NewMEDICATION_REQUEST_DOSAGE_METHOD_CODINGmedication_request_dosage_method_id, system, code, display
NewMEDICATION_REQUEST_DOSAGE_ROUTEid, display
NewMEDICATION_REQUEST_DOSAGE_ROUTE_CODINGmedication_request_dosage_route_id, system, code, display
NewMEDICATION_REQUEST_MEDICATION_CODEid, display
NewMEDICATION_REQUEST_MEDICATION_CODE_CODINGmedication_request_medication_code_id, system, code, display, is_active_ingredient
NewMEDICATION_STATEMENT_DOSAGEid, display, timing_repeat_period_unit, timing_repeat_bounds_start, timing_repeat_bounds_end, timing_period, medication_statement_dosage_route_id, medication_statement_dosage_method_id, additional_instruction_display, dose_quantity_unit, dose_quantity_value
NewMEDICATION_STATEMENT_DOSAGE_METHODid, display
NewMEDICATION_STATEMENT_DOSAGE_METHOD_CODINGmedication_statement_dosage_method_id, system, code, display
NewMEDICATION_STATEMENT_DOSAGE_ROUTEid, display
NewMEDICATION_STATEMENT_DOSAGE_ROUTE_CODINGmedication_statement_dosage_route_id, system, code, display
NewMEDICATION_STATEMENT_MEDICATION_CODEid, display
NewMEDICATION_STATEMENT_MEDICATION_CODE_CODINGmedication_statement_medication_code_id, system, code, display, is_active_ingredient
NewOBSERVATION_BODY_SITEid, display
NewOBSERVATION_BODY_SITE_CODINGobservation_body_site_id, system, code, display
NewPROCEDURE_BODY_SITEid, display
NewPROCEDURE_BODY_SITE_CODINGprocedure_body_site_id, system, code, display

Table: ALLERGY_INTOLERANCE_IDENTIFIER

The columns in this table replicate columns in the IDENTIFIER table. Previously, retrieving the identifier system and value required a three-way join between ALLERGY_INTOLERANCE, ALLERGY_INTOLERANCE_IDENTIFIER, and IDENTIFIER. These new columns obviate the need to join to IDENTIFIER.

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: APPOINTMENT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: CARE_PLAN_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: CARE_TEAM_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: CARE_TEAM_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use

Table: CONDITION_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: CONSENT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: COVERAGE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: DEVICE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: DEVICE_USE_STATEMENT_BODY_SITE

This table provides the same content as BODY_SITE_CONCEPT, but limited to DeviceUseStatement resources. Joining DEVICE_USE_STATEMENT to this table yields better performance than BODY_SITE_CONCEPT.

Columns:

Column NameData TypeDescription
idvarcharID of code
displayvarcharPlain text representation of the body site code. This field comes from the "text" field on the bodySite field.

New Table: DEVICE_USE_STATEMENT_BODY_SITE_CODING

This table provides the same content as BODY_SITE_CONCEPT_CODING, but limited to DeviceUseStatement resources. Joining DEVICE_USE_STATEMENT_BODY_SITE to this table yields better performance than BODY_SITE_CONCEPT_CODING.

Columns:

Column NameData TypeDescription
device_use_statement_body_site_idvarcharID of the Body Site Code
systemvarcharURI of the terminology system
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: DEVICE_USE_STATEMENT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: DIAGNOSTIC_REPORT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: DOCUMENT_REFERENCE

The new columns directly surface the values of the masterIdentifier field in the DocumentReference, so that the table doesn't need to be joined to the IDENTIFIER table to retrieve these values.

New columns:

Column NameData TypeDescription
master_identifier_systemvarcharThe namespace for the document's master identifier value
master_identifier_valuevarcharThe value that is unique within the document's master identifier system
master_identifier_usevarcharThe purpose of this document's master identifier
master_identifier_assigner_displayvarcharDisplay text for the organization that assigned the document's master identifier

Table: DOCUMENT_REFERENCE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: ENCOUNTER_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: FAMILY_MEMBER_HISTORY_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: GOAL_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: IMMUNIZATION_BODY_SITE

This table provides the same content as BODY_SITE_CONCEPT, but limited to Immunization resources. Joining IMMUNIZATION to this table yields better performance than BODY_SITE_CONCEPT.

Columns:

Column NameData TypeDescription
idvarcharID of code
displayvarcharPlain text representation of the body site code. This field comes from the "text" field on the bodySite field.

New Table: IMMUNIZATION_BODY_SITE_CODING

This table provides the same content as BODY_SITE_CONCEPT_CODING, but limited to Immunization resources. Joining IMMUNIZATION_BODY_SITE to this table yields better performance than BODY_SITE_CONCEPT_CODING.

Columns:

Column NameData TypeDescription
immunization_body_site_idvarcharID of the Body Site Code
systemvarcharURI of the terminology system
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: IMMUNIZATION_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: IMMUNIZATION_ROUTE

This table provides the same content as ROUTE_CONCEPT, but limited to Immunization resources. Joining IMMUNIZATION to this table yields better performance than ROUTE_CONCEPT.

Columns:

Column NameData TypeDescription
idvarcharID of code
displayvarcharPlain text representation of the route code. This field comes from the "text" field on the route field.

New Table: IMMUNIZATION_ROUTE_CODING

This table provides the same content as ROUTE_CONCEPT_CODING, but limited to Immunization resources. Joining IMMUNIZATION_ROUTE to this table yields better performance than ROUTE_CONCEPT_CODING.

Columns:

Column NameData TypeDescription
immunization_route_idvarcharID of the Body Site Code
systemvarcharURI of the terminology system
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: LENS_ENCOUNTER_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: LENS_RXNORM_MEDICATION_STATEMENT_DOSAGE

This table provides the contents available in DOSAGE, but limited to Lens MedicationStatement resources. Joining LENS_RXNORM_MEDICATION_STATEMENT to this table yields better performance than DOSAGE.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage element
timing_repeat_period_unitvarcharUnit for the timing schedule for when the medication should be administered
timing_repeat_bounds_starttimestamp_tzStart of when medication should be administered
timing_repeat_bounds_endtimestamp_tzEnd of when medication should be administered
timing_perioddecimalIndicates the duration of time over which repetitions are to occur
lens_rxnorm_medication_statement_dosage_route_idvarcharID of the route concept that expresses how the drug should enter body
lens_rxnorm_medication_statement_dosage_method_idvarcharID of the method concept that expresses the technique for administering medication
additional_instruction_displayvarcharSupplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
dose_quantity_unitvarcharUnit of the amount of medication per dose
dose_quantity_valuedecimalAmount of medication per dose

New Table: LENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_METHOD

This table provides the same content as DOSAGE_METHOD, but limited to Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage method
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: LENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_METHOD_CODING

This table provides the same content as DOSAGE_METHOD_CODING, but limited to Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
lens_rxnorm_medication_statement_dosage_method_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

New Table: LENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_ROUTE

This table provides the same content as ROUTE_CONCEPT, but limited to dosage references on Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage route
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: LENS_RXNORM_MEDICATION_STATEMENT_DOSAGE_ROUTE_CODING

This table provides the same content as ROUTE_CONCEPT_CODING, but limited to dosage references on Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
lens_rxnorm_medication_statement_dosage_route_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

New Table: LENS_RXNORM_MEDICATION_STATEMENT_MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: LENS_RXNORM_MEDICATION_STATEMENT_MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to Lens MedicationStatement resources.

Columns:

Column NameData TypeDescription
lens_rxnorm_medication_statement_medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

Table: LENS_TRANSITION_OF_CARE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: LOCATION_IDENTIFIER

Note: the columns shown below have been available since August 2025, but were not documented in a release note.

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: LOCATION_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use

New Table: MEDICATION_ADMINISTRATION_DOSAGE_ROUTE

This table provides the same content as ROUTE_CONCEPT, but limited to dosage references on MedicationAdministration resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage route
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: MEDICATION_ADMINISTRATION_DOSAGE_ROUTE_CODING

This table provides the same content as ROUTE_CONCEPT_CODING, but limited to dosage references on MedicationAdministration resources.

Columns:

Column NameData TypeDescription
medication_administration_dosage_route_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: MEDICATION_ADMINISTRATION_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: MEDICATION_ADMINISTRATION_MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to MedicationAdministration resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: MEDICATION_ADMINISTRATION_MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to MedicationAdministration resources.

Columns:

Column NameData TypeDescription
medication_administration_medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

New Table: MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to Medication resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to Medication resources.

Columns:

Column NameData TypeDescription
medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

Table: MEDICATION_DISPENSE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: MEDICATION_DISPENSE_MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to MedicationDispense resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: MEDICATION_DISPENSE_MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to MedicationDispense resources.

Columns:

Column NameData TypeDescription
medication_dispense_medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

New Table: MEDICATION_REQUEST_DOSAGE

This table provides the contents available in DOSAGE, but limited to MedicationRequest resources. Joining MEDICATION_REQUEST to this table yields better performance than DOSAGE.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage element
timing_repeat_period_unitvarcharUnit for the timing schedule for when the medication should be administered
timing_repeat_bounds_starttimestamp_tzStart of when medication should be administered
timing_repeat_bounds_endtimestamp_tzEnd of when medication should be administered
timing_perioddecimalIndicates the duration of time over which repetitions are to occur
medication_request_dosage_route_idvarcharID of the route concept that expresses how the drug should enter body
medication_request_dosage_method_idvarcharID of the method concept that expresses the technique for administering medication
additional_instruction_displayvarcharSupplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
dose_quantity_unitvarcharUnit of the amount of medication per dose
dose_quantity_valuedecimalAmount of medication per dose

New Table: MEDICATION_REQUEST_DOSAGE_METHOD

This table provides the same content as DOSAGE_METHOD, but limited to MedicationRequest resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage method
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: MEDICATION_REQUEST_DOSAGE_METHOD_CODING

This table provides the same content as DOSAGE_METHOD_CODING, but limited to MedicationRequest resources.

Columns:

Column NameData TypeDescription
medication_request_dosage_method_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

New Table: MEDICATION_REQUEST_DOSAGE_ROUTE

This table provides the same content as ROUTE_CONCEPT, but limited to dosage references on MedicationRequest resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage route
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: MEDICATION_REQUEST_DOSAGE_ROUTE_CODING

This table provides the same content as ROUTE_CONCEPT_CODING, but limited to dosage references on MedicationRequest resources.

Columns:

Column NameData TypeDescription
medication_request_dosage_route_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: MEDICATION_REQUEST_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: MEDICATION_REQUEST_MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to MedicationRequest resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: MEDICATION_REQUEST_MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to MedicationRequest resources.

Columns:

Column NameData TypeDescription
medication_request_medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

New Table: MEDICATION_STATEMENT_DOSAGE

This table provides the contents available in DOSAGE, but limited to MedicationStatement resources. Joining MEDICATION_STATEMENT to this table yields better performance than DOSAGE.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage element
timing_repeat_period_unitvarcharUnit for the timing schedule for when the medication should be administered
timing_repeat_bounds_starttimestamp_tzStart of when medication should be administered
timing_repeat_bounds_endtimestamp_tzEnd of when medication should be administered
timing_perioddecimalIndicates the duration of time over which repetitions are to occur
medication_statement_dosage_route_idvarcharID of the route concept that expresses how the drug should enter body
medication_statement_dosage_method_idvarcharID of the method concept that expresses the technique for administering medication
additional_instruction_displayvarcharSupplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
dose_quantity_unitvarcharUnit of the amount of medication per dose
dose_quantity_valuedecimalAmount of medication per dose

New Table: MEDICATION_STATEMENT_DOSAGE_METHOD

This table provides the same content as DOSAGE_METHOD, but limited to MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage method
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: MEDICATION_STATEMENT_DOSAGE_METHOD_CODING

This table provides the same content as DOSAGE_METHOD_CODING, but limited to MedicationStatement resources.

Columns:

Column NameData TypeDescription
medication_statement_dosage_method_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

New Table: MEDICATION_STATEMENT_DOSAGE_ROUTE

This table provides the same content as ROUTE_CONCEPT, but limited to dosage references on MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the dosage route
displayvarcharPlain text representation of the dosage. This field comes from the "text" field on the dosage method

New Table: MEDICATION_STATEMENT_DOSAGE_ROUTE_CODING

This table provides the same content as ROUTE_CONCEPT_CODING, but limited to dosage references on MedicationStatement resources.

Columns:

Column NameData TypeDescription
medication_statement_dosage_route_idvarcharID of the dosage method
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: MEDICATION_STATEMENT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: MEDICATION_STATEMENT_MEDICATION_CODE

This table provides the same content as MEDICATION_CONCEPT, but limited to MedicationStatement resources.

Columns:

Column NameData TypeDescription
idvarcharID of the medication code
displayvarcharPlain text representation of the medication taken. This field comes from the "text" field on the code element

New Table: MEDICATION_STATEMENT_MEDICATION_CODE_CODING

This table provides the same content as MEDICATION_CONCEPT_CODING, but limited to MedicationStatement resources.

Columns:

Column NameData TypeDescription
medication_statement_medication_code_idvarcharID of the medication code
systemvarcharURI of the terminology system, for example http://snomed.info/sct
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code
is_active_ingredientvarcharIndicates if this coding represents an active ingredient

New Table: OBSERVATION_BODY_SITE

This table provides the same content as BODY_SITE_CONCEPT, but limited to Observation resources. Joining OBSERVATION to this table yields better performance than BODY_SITE_CONCEPT.

Columns:

Column NameData TypeDescription
idvarcharID of code
displayvarcharPlain text representation of the body site code. This field comes from the "text" field on the bodySite field.

New Table: OBSERVATION_BODY_SITE_CODING

This table provides the same content as BODY_SITE_CONCEPT_CODING, but limited to Observation resources. Joining OBSERVATION_BODY_SITE to this table yields better performance than BODY_SITE_CONCEPT_CODING.

Columns:

Column NameData TypeDescription
observation_body_site_idvarcharID of the Body Site Code
systemvarcharURI of the terminology system
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: OBSERVATION_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: ORGANIZATION_IDENTIFIER

Note: the columns shown below have been available since August 2025, but were not documented in a release note.

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: ORGANIZATION_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use

Table: PATIENT_CONTACT_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use

Table: PATIENT_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: PATIENT_NAME

New columns:

Column NameData TypeDescription
displayvarcharText representation of the full name
familyvarcharFamily name (often called surname)
given_1varcharFirst given name
given_2varcharSecond given name
prefix_1varcharName prefix
suffix_1varcharName suffix
period_starttimestamp_tzStart of time period when name is/was in use
period_endtimestamp_tzEnd of time period when name is/was in use

Table: PATIENT_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use

Table: PRACTITIONER_IDENTIFIER

Note: the columns shown below have been available since August 2025, but were not documented in a release note.

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

New Table: PROCEDURE_BODY_SITE

This table provides the same content as BODY_SITE_CONCEPT, but limited to Procedure resources. Joining PROCEDURE to this table yields better performance than BODY_SITE_CONCEPT.

Columns:

Column NameData TypeDescription
idvarcharID of code
displayvarcharPlain text representation of the body site code. This field comes from the "text" field on the bodySite field.

New Table: PROCEDURE_BODY_SITE_CODING

This table provides the same content as BODY_SITE_CONCEPT_CODING, but limited to Procedure resources. Joining PROCEDURE_BODY_SITE to this table yields better performance than BODY_SITE_CONCEPT_CODING.

Columns:

Column NameData TypeDescription
procedure_body_site_idvarcharID of the Body Site Code
systemvarcharURI of the terminology system
codevarcharCode symbol defined by the terminology system
displayvarcharHuman-readable string representing the code

Table: PROCEDURE_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: RELATED_PERSON_IDENTIFIER

New columns:

Column NameData TypeDescription
systemvarcharURI of the identifier
valuevarcharCode symbol defined by the terminology system
usevarcharThe purpose of the identifier
type_displayvarcharPlain text representation of the identifier type. This field comes from the "text" field in the identifier type field
assigner_displayvarcharDisplay name of the organization that issued this identifier

Table: RELATED_PERSON_TELECOM

New columns:

Column NameData TypeDescription
systemvarcharTelecommunications form for contact point - what communications system is required to make use of the contact. Possible values: phone / fax / email / pager / url / sms / other
valuevarcharThe actual contact point details
usevarcharPurpose of this contact point. Possible values: home / work / temp / old / mobile
rankvarcharSpecify preferred order of use (1 = highest)
period_starttimestamp_ntzStart of the time period when the contact point was/is in use
period_endtimestamp_ntzEnd of the time period when the contact point was/is in use