Kenya Emergency FHIR Implementation Guide - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
These are profiles on resources or data types that describe patterns used by other profiles, but cannot be instantiated directly. I.e. instances can conform to profiles based on these abstract profiles but do not declare conformance to the abstract profiles themselves.
| Observation - Caller Reported |
Represents unverified clinical information reported by a caller or dispatcher before physical patient assessment by an emergency medical practitioner. Caller-reported observations must remain distinct from observations recorded after direct clinical assessment. |
These define constraints on FHIR resources for systems conforming to this implementation guide.
| AllergyIntolerance - Emergency Allergy or Intolerance |
Represents a patient's allergy or intolerance recorded during Kenya emergency medical services and facility workflows. Criticality and reaction detail are must-fetch on patient lookup and must never be silently dropped. By the time the allergy-history section of an assessment is marked complete, the patient must have either one or more EMAllergyIntolerance instances with a real allergen code, or exactly one EMNoKnownAllergy instance — never both, never neither. |
| AllergyIntolerance - Emergency Allergy or Intolerance (v1, permissive) |
A looser variant of EMAllergyIntolerance for sources that capture allergy history as free text during initial intake (e.g. "Penicillin allergy", manifestation "moderate") rather than fully coded clinicalStatus, verificationStatus, and criticality. Use EMAllergyIntolerance instead once a source can supply those fields. |
| AllergyIntolerance - No Known Allergy |
An explicit record asserting that a full allergy history was taken and nothing was found, distinct from simply having zero AllergyIntolerance resources. The absence of any AllergyIntolerance resource is ambiguous — it could mean 'confirmed none' or 'never asked' — and that ambiguity is exactly the kind of gap that can lead to a contraindicated drug being administered. |
| DiagnosticReport - Emergency Investigation Result |
Represents an emergency investigation result, e.g. a 12-lead ECG, laboratory result, or imaging report, generated during pre-hospital or facility-based emergency care. |
| Encounter - Emergency Medical Incident |
Represents the complete emergency medical services incident from dispatch initiation through handover at the receiving facility. This Encounter is the root encounter for an EMS episode. It captures dispatch information, the reporting caller, the dispatcher, responding units, participating emergency agencies, scene information, and the destination facility. Clinical care performed by the responding emergency team should be represented using a separate point-of-care Encounter whose partOf element references this Encounter. |
| Encounter - Emergency Point of Care |
Represents the direct patient-care encounter performed by an emergency medical team at the scene or during transport. The point-of-care Encounter is subordinate to the root emergency incident Encounter and references it through Encounter.partOf. |
| Flag - Emergency Allergy Criticality Alert |
A prominent, must-see alert referencing a high-criticality EMAllergyIntolerance record. Reuses the base FHIR Flag resource, designed exactly for prominent alerts, rather than requiring every consuming system to know a local convention on AllergyIntolerance. Intended for use specifically with EMAllergyIntolerance instances where criticality = high. |
| Location - Emergency Destination Facility |
Represents the physical healthcare facility or emergency-care location intended to receive, or that actually received, a patient transported by emergency medical services. The Location identifies the physical destination. The organization operating the facility is referenced through Location.managingOrganization. |
| Location - Emergency Incident Scene |
Represents the physical location at which an emergency incident occurred or at which the patient was found. The location supports coordinates, landmarks, descriptive directions, and administrative geographic details. |
| Location - Emergency Responder Unit Position |
Represents the real-time geographic position and response status of an emergency responder unit, referenced from EMResponderUnit.location. |
| MedicationAdministration - Emergency Medication Administration |
Represents a medication administered to a patient during Kenya emergency medical services and facility clinical workflows. Used instead of MedicationRequest because emergency care is administration-heavy — drugs are given in real time, not merely prescribed. |
| Observation - Caller-Reported Active Bleeding |
Represents whether active bleeding was reported by the caller or dispatcher before direct clinical assessment. |
| Observation - Caller-Reported Breathing Status |
Represents the patient's apparent breathing status as reported by a caller or dispatcher before direct clinical assessment. |
| Observation - Caller-Reported Level of Consciousness |
Represents the patient's apparent level of consciousness as reported by the caller or dispatcher before direct clinical assessment. |
| Observation - Emergency Investigation |
Represents a single investigation (lab test, imaging study, or similar) ordered or resulted during emergency care — one Observation instance per investigation, mirroring the explicit-absence pattern used on EMSecondarySurveyObservation. |
| Observation - Emergency Secondary Survey |
Represents the examination of a single body region during an emergency secondary survey — one Observation instance per body region examined (head, neck, chest, back-and-spine, abdomen, pelvis, upper-extremities, lower-extremities), not one Observation for the whole secondary survey. Mirrors the explicit-absence pattern used on EMAllergyIntolerance: a region with nothing abnormal found must be recorded as an explicit "examined, no findings" Observation, never left as a silently-missing resource. A full-body exam is expected to produce exactly 8 Observation instances (fewer only if the survey was genuinely partial, e.g. limited by scene safety) — that expectation is a workflow-completeness rule, not a FHIR structural constraint on this profile. |
| Observation - Emergency Triage Acuity |
A standalone, trendable triage acuity record, separate from EMIncidentEncounter.priority (dispatch) and EMPOCEncounter.priority (on-scene). Only create this Observation when the workflow needs acuity trending as discrete timestamped events; if a single current-priority value per encounter is sufficient, Encounter.priority alone is enough and this Observation is unnecessary. |
| Observation - Emergency Vital Signs |
Represents a single vital-sign measurement (heart rate, respiratory rate, temperature, SpO2, blood pressure, or Glasgow Coma Scale) captured during Kenya emergency medical services and point-of-care workflows. Largely reuses the standard FHIR vital-signs pattern rather than inventing new structure. One Observation instance is created per measurement, per reading time, so trends across the episode (dispatch snapshot, on-scene, in-transit, ED arrival) can be reconstructed. |
| Procedure - Emergency Clinical Procedure |
Represents a clinical procedure performed during Kenya emergency medical services and point-of-care workflows, e.g. CPR, endotracheal intubation, wound dressing, or splinting. |
| Procedure - Emergency Clinical Procedure (v2) |
Same as EMProcedure, except |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| Emergency Centre Capability |
Describes whether a destination facility provides emergency-care services and the level of emergency capability available. |
| Emergency Clinical Guidance Message |
Auto-generated clinical guidance text tied to an observation's severity flag, e.g. instructions to start supplemental oxygen and reassess airway and breathing. |
| Emergency Destination Facility Level |
Represents the Kenya health-system level assigned to a receiving healthcare facility. |
| Emergency Incident Caller |
Captures the person who reported the emergency incident. The caller may be the Patient, a person related to the Patient, or an unlinked person such as a bystander. This extension is necessary because the base Encounter.participant.individual element does not permit Patient or Person references in FHIR R4/R4B. |
| Emergency Medication Administration Attempts |
Number of attempts made to administer a medication, relevant for repeated-dose protocols and difficult-access scenarios. |
| Emergency No Findings On Exam |
Explicit flag confirming that a body region was examined and that nothing abnormal was found. |
| Emergency No Investigation Performed |
Explicit flag confirming whether an investigation/result value is present on this Observation. |
| Emergency Patient Adult Status |
Indicates whether the patient is considered an adult during emergency assessment or triage. |
| Emergency Patient Approximate Age |
Represents the patient's estimated age when the exact date of birth is unknown or has not been verified. |
| Emergency Patient Identity Verified |
Indicates whether the patient's identity has been verified through an appropriate identification or verification process. May be recorded on the Patient resource directly, or on a point-of-care Encounter to capture that the emergency team confirmed identity at that specific encounter. When recorded on an Encounter, the linked Patient resource should also be updated so downstream systems (e.g. claims adjudication) can key off the Patient-level value alone. |
| Emergency Responder Crew Member |
Represents a practitioner or practitioner role assigned to an emergency responder unit. The extension records both the assigned person or role and their operational crew function. |
| Emergency Responder Unit Last Location Updated At |
Date and time the responder unit's geographic position was last refreshed. |
| Emergency Responder Unit Ownership Type |
Ownership category of the organization operating an emergency responder unit, e.g. government, private, or NGO. |
| Emergency Responder Unit Relieved Status |
Indicates whether a responder unit has been stood down or replaced by another unit during the incident. |
| Emergency Responder Unit Response Status |
The responder unit's current response state, e.g. dispatched, en-route, on-scene, transporting, or at-facility. |
| Emergency Responder Unit Telematics Device Identifier |
Identifier of the onboard telematics or tracking device fitted to an emergency responder unit, if present. |
| Emergency Responding Unit |
References an ambulance or other emergency-response vehicle assigned to the incident. |
| Emergency Supporting Agency |
References another emergency-response organization participating in the incident, such as fire services, police, security services, or disaster management services. |
| Emergency Unidentified Patient |
Indicates whether the Patient resource represents an individual whose identity has not yet been established. |
| Emergency Vital Sign Age Group |
Age-group bucket used to select the applicable reference range for a vital-sign reading, e.g. adult versus paediatric. |
| Emergency Vital Sign Qualitative State |
Qualitative descriptor of a vital-sign reading, independent of its numeric value, e.g. a pulse described as weak or a breathing pattern described as labored. |
| Incident Priority |
Dispatcher-assigned priority at call intake. Maps to incident.priority_level. Represents the INITIAL priority only — do not overwrite with on-scene EMT triage acuity. |
| Number of Patients |
Number of patients associated with this incident/dispatch. Maps to incident.number_of_patients. Kept at the EpisodeOfCare (incident) level, not duplicated on child Encounters. If >1, expect multiple EMEpisodeOfCare/Patient chains linked via identifier:groupIncidentId. |
These define sets of codes used by systems conforming to this implementation guide.
| AVPU Scale Value Set |
Permitted AVPU responsiveness values. |
| Active Components Value Set |
Drug/allergen active-component codes used for allergen and medication coding. |
| Ambulance Case Status |
ValueSet for ambulance case status. |
| Assessment Types |
ValueSet for types of clinical assessments. |
| Dose Units |
ValueSet for units used in medication dosing. |
| EM Priority Level ValueSet |
Value set for the incidentPriority extension. Maps to incident.priority_level. |
| Emergency Age Group Value Set |
Permitted age-group buckets used to select a reference range. |
| Emergency Body Assessment Finding Value Set |
Findings that may be observed at a body region during an emergency secondary survey. |
| Emergency Body Region Value Set |
Permitted body regions examined during an emergency secondary survey. |
| Emergency Breathing Status Value Set |
Permitted breathing-status values. |
| Emergency Caller Relationship Value Set |
Permitted relationships between an emergency caller and the patient. |
| Emergency Centre Capability Value Set |
Permitted emergency-care capability classifications for destination facilities. |
| Emergency Clinical Acuity Value Set | |
| Emergency Destination Facility Type Value Set |
Permitted facility types for an emergency transport destination. |
| Emergency Diagnosis Staging Category Value Set |
Permitted diagnostic stages for an emergency Condition instance. |
| Emergency Dispatch Priority Value Set |
Permitted dispatch priorities assigned during emergency call intake. |
| Emergency Incident Type Value Set |
Permitted high-level classifications of emergency incidents. |
| Emergency Investigation Codes Value Set |
Permitted investigation codes for emergency care, sourced from the MOH-PPB "EmergencyInvestigations" collection on Kenya's OCL terminology server. |
| Emergency Investigation Value Set |
Single-value ValueSet containing only the generic "EM Investigation" concept. |
| Emergency Patient Identifier Type ValueSet |
Allowed official identifier types for an emergency patient in Kenya. |
| Emergency Point-of-Care Encounter Type Value Set | |
| Emergency Procedure Codes Value Set |
Permitted procedure codes for emergency care, sourced from the MOH-PPB "EmergencyProcedures" collection on Kenya's OCL terminology server. |
| Emergency Responder Crew Role Value Set |
Permitted roles for personnel assigned to an emergency responder unit. |
| Emergency Responder Unit Ownership Type Value Set |
Permitted ownership categories for an emergency responder unit. |
| Emergency Responder Unit Response Status Value Set |
Permitted real-time response states for an emergency responder unit. |
| Emergency Responder Unit Type Value Set |
Permitted types of vehicles and mobile units participating in an emergency response. |
| Emergency Scene Location Type Value Set |
Permitted classifications for emergency incident scene locations. |
| Emergency Secondary Survey Region Value Set |
Permitted secondary-survey region examination codes. |
| Emergency Supporting Agency Type Value Set |
Permitted types of emergency-response organizations participating in an incident. |
| Emergency Vital Sign Qualitative State Value Set |
Permitted qualitative descriptors for a vital-sign reading. |
| Emergency Vital Signs ValueSet |
List of vital-signs LOINC codes used by this IG. |
| Investigation Codes ValueSet |
ValueSet containing investigation codes for procedures. |
| Kenya Health Facility Level Value Set |
Permitted Kenya health-system facility levels. |
| Manifestation or Symptom ValueSet |
Clinical manifestations and symptoms. |
| Medication Administration Route |
ValueSet for routes of medication administration. |
| Procedure Code Value Set |
Local procedure code list, supplementing SNOMED CT procedure codes. |
These define new code systems used by systems conforming to this implementation guide.
| AVPU Scale |
AVPU scale used to describe a patient's responsiveness. |
| Active Components CodeSystem |
Active pharmaceutical ingredient codes from MOH PPB OCL. |
| Allergy Reporter |
Identifies the source reporting an allergy. |
| Ambulance Case Rejection Reason |
Defines reasons for rejecting an ambulance case. |
| Ambulance Case Status |
Defines the lifecycle statuses of an ambulance case. |
| Ambulance Dispatch Source GCS Eye-Opening Codes |
Raw GCS eye-opening response codes as sent by the ambulance dispatch source system (e.g. Observation.value/assessment.gcs.eye_opening = "XC3W"). The originating code system for these codes has not been verified against a published standard; they are captured here only so a ConceptMap can crosswalk them to this IG's own EMGCSEyeOpeningCS. See EMGCSCrosswalkCM. |
| Ambulance Dispatch Source GCS Motor Response Codes |
Raw GCS motor response codes as sent by the ambulance dispatch source system. The originating code system for these codes has not been verified against a published standard; they are captured here only so a ConceptMap can crosswalk them to this IG's own EMGCSMotorResponseCS. See EMGCSCrosswalkCM. |
| Ambulance Dispatch Source GCS Verbal Response Codes |
Raw GCS verbal response codes as sent by the ambulance dispatch source system. The originating code system for these codes has not been verified against a published standard; they are captured here only so a ConceptMap can crosswalk them to this IG's own EMGCSVerbalResponseCS. See EMGCSCrosswalkCM. |
| Assessment Types |
Specifies types of clinical assessments for patient evaluation. |
| Breathing State Classification |
Clinical classification of breathing rate states. |
| Case Priority |
Defines priority levels for cases. |
| CodeSystem for Code systems |
CodeSystem for Code systems |
| CodeSystem for Contact Relationship |
CodeSystem for Contact Relationship |
| CodeSystem for patient's identifier Types |
CodeSystem for patient's identifier Types |
| CodeSystem for patient's title |
CodeSystem for patient's title |
| Coding System Source |
Identifies the terminology source from which a clinical code originates. |
| Condition Statuses |
Clinical severity statuses for a patient condition. |
| Dose Units |
Units used to specify medication doses, sourced from the Kenya MOH National Product Catalogue (NPC). |
| EM Priority Level Code System |
Dispatcher-assigned priority levels at call intake. |
| Emergency Age Group |
Age-group bucket used to select the applicable clinical reference range for an emergency observation. |
| Emergency Body Assessment Finding |
Findings that may be observed at a body region during an emergency secondary survey (physical exam). |
| Emergency Body Region |
Body regions examined during an emergency secondary survey. |
| Emergency Breathing Status |
Caller- or practitioner-reported categories describing the patient's apparent breathing status. |
| Emergency Caller Relationship |
Relationship of an emergency caller to the patient. |
| Emergency Centre Capability |
Emergency-care capabilities available at a receiving health facility. |
| Emergency Clinical Acuity |
Clinical acuity assigned by an emergency practitioner after patient assessment. This terminology is distinct from dispatch priority. |
| Emergency Destination Facility Type |
Types of healthcare locations that may receive an emergency patient. |
| Emergency Diagnosis Staging Category |
Diagnostic stage represented by an emergency Condition instance, from initial chief complaint through discharge diagnosis. |
| Emergency Dispatch Priority |
Priority assigned to an emergency incident during call intake. |
| Emergency Encounter Participant Role |
Roles performed by people or organizations involved in an emergency incident. |
| Emergency GCS Eye-Opening Response |
Glasgow Coma Scale eye-opening response categories (LOINC 9267-6). |
| Emergency GCS Motor Response |
Glasgow Coma Scale motor response categories (LOINC 9268-4). |
| Emergency GCS Verbal Response |
Glasgow Coma Scale verbal response categories (LOINC 9270-0). |
| Emergency Incident Type |
High-level classification of an emergency incident. |
| Emergency Investigation |
Single-value marker CodeSystem for the generic "EM Investigation" category. |
| Emergency Investigation Codes |
LOINC codes for investigations commonly ordered in emergency care, sourced from the MOH-PPB "EmergencyInvestigations" collection on Kenya's OCL terminology server (ilm-hie.dha.go.ke). |
| Emergency Observation Category |
Categories used to distinguish emergency observations by their source and clinical verification status. |
| Emergency Observation Code |
Local codes for emergency medical observations not adequately represented by a single preferred external terminology code. |
| Emergency Patient Identifier Type |
Identifier types used to identify patients receiving emergency or pre-hospital services in Kenya. |
| Emergency Point-of-Care Encounter Type |
Types of direct patient-care interactions performed during emergency response. |
| Emergency Procedure Codes |
ICHI (International Classification of Health Interventions, WHO) codes for procedures commonly performed in emergency care, sourced from the MOH-PPB "EmergencyProcedures" collection on Kenya's OCL terminology server (ilm-hie.dha.go.ke). |
| Emergency Responder Crew Role |
Operational roles performed by personnel assigned to an emergency responder unit. |
| Emergency Responder Unit Ownership Type |
Ownership category of an organization operating an emergency responder unit. |
| Emergency Responder Unit Response Status |
Current operational response state of an emergency responder unit during an incident. |
| Emergency Responder Unit Type |
Types of vehicles and mobile units used during emergency response. |
| Emergency Scene Location Type |
Types of physical locations at which emergency incidents may occur. |
| Emergency Secondary Survey Region |
Identifies a secondary-survey physical examination as pertaining to a specific body region. |
| Emergency Supporting Agency Type |
Types of organizations that may participate in an emergency response. |
| Emergency Vital Sign Qualitative State |
Qualitative descriptor of a vital-sign reading that is independent of, and supplements, its numeric value. |
| Entry Types |
Defines the type of clinical entry recorded in the health record. |
| Investigation Codes |
Defines Investigation Codes for Procedures. |
| KHTS.A CodeSystem for Counties in Kenya |
CodeSystem for KHTS.A Counties in Kenya |
| Kenya Health Facility Level |
Levels used to classify health facilities in the Kenya health system. |
| Manifestation or Symptom CodeSystem |
Clinical manifestations and symptoms used in allergy reactions, conditions, and observations. Source: MOH-KENYA OCL MANIFESTATION-OR-SYMPTOM. |
| Medication Administration Route |
Route by which a medication is administered, sourced from the Kenya MOH National Product Catalogue (NPC). |
| No Known Allergy Code System |
Fixed assertion code for an explicit no-known-allergy record, replacing SNOMED CT-based HL7 ValueSet |
| Procedure Code CodeSystem |
Clinical procedure codes used in care plan activities and service requests. Source: MOH-KENYA OCL PROCEDURE-CODE. |
| Pulse State Classification |
Clinical classification of pulse rate states. |
| Questionnaire Category |
Categories used to classify questionnaires or assessments. |
| Vital Signs LOINC Codes |
LOINC codes commonly used for vital signs observations. |
These define identifier and/or code system identities used by systems conforming to this implementation guide.
| NamingSystem - Emergency Dispatch Identifier |
Identifier system assigned by the dispatch or computer-aided dispatch (CAD) system to an emergency incident. |
| NamingSystem - Emergency Incident Identifier |
Shared identifier system used to associate an emergency incident across EMEpisodeOfCare, EMIncidentEncounter, and EMPOCEncounter. |
| NamingSystem - Kenya Emergency Record Identifier |
Identifier system for records created within the Kenya emergency and ambulance services workflow. |
| NamingSystem - Kenya National ID |
Unique national identifier assigned to Kenyan citizens and residents. |
| NamingSystem - Point-of-Care Encounter Identifier |
Local identifier system unique to a specific point-of-care encounter instance, used when a single incident involves more than one point-of-care encounter. |
These define transformations to convert between codes by systems conforming with this implementation guide.
| GCS Crosswalk: Ambulance Dispatch Source to This IG's GCS CodeSystems |
Maps the ambulance dispatch source system's own GCS eye-opening, motor response, and verbal response codes (EMSourceGCSEyeOpeningCS, EMSourceGCSMotorResponseCS, EMSourceGCSVerbalResponseCS) onto this IG's own EMGCSEyeOpeningCS, EMGCSMotorResponseCS, and EMGCSVerbalResponseCS. Use via $translate during ingestion so a raw source value such as "XC3W" is converted to this IG's "spontaneous" before being placed on EMVitalSignsObservation.component[gcsEye] (and similarly for gcsMotor and gcsVerbal). |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
| AllergyIntolerance - Domiphen Allergy |
Example confirmed severe allergy resulting in anaphylaxis. |
| AllergyIntolerance - Invalid Example |
Invalid allergy example demonstrating a missing required criticality. |
| AllergyIntolerance - No Known Allergy |
Example explicit no-known-allergy assertion recorded after a full allergy history was taken. |
| DiagnosticReport - 12-Lead ECG Showing STEMI |
Example ECG investigation result flagging an anterior STEMI. |
| DiagnosticReport - Invalid Example |
Invalid diagnostic report example demonstrating a missing required category, tightened to 1..1 on this profile though optional in base DiagnosticReport. |
| Encounter - Emergency Incident |
Example root emergency incident Encounter for a road traffic trauma case. |
| Encounter - Emergency Point of Care |
Example point-of-care Encounter for direct patient assessment and treatment during the incident above. |
| Flag - High-Criticality Allergy Alert |
Example must-see alert referencing the high-criticality Domiphen allergy above. |
| Location - Kenyatta National Hospital Emergency Centre |
Example receiving facility for emergency transport. |
| Location - Mbagathi Road Incident Scene |
Example emergency incident scene location. |
| Location - Responder Unit Real-Time Position |
Example real-time position of the ambulance responding to the incident. |
| MedicationAdministration - Epinephrine |
Example emergency medication administration during resuscitation. |
| MedicationAdministration - Invalid Example |
Invalid medication administration example demonstrating a missing encounter context, tightened to 1..1 on this profile though optional in base MedicationAdministration. |
| Observation - Blood Pressure Panel |
Example blood-pressure panel with systolic and diastolic components. |
| Observation - Glasgow Coma Scale |
Example GCS total with eye/verbal/motor sub-scores captured separately. |
| Observation - Heart Rate |
Example heart-rate vital sign showing a critical qualitative pulse state. |
| Observation - Secondary Survey Invalid Example |
Invalid exam example: a finding is coded but noFindingsOnExam is left true, violating invariant em-exam-1. |
| Observation - Secondary Survey, Head (No Findings) |
Example head examination with no abnormal findings, explicitly recorded. |
| Observation - Secondary Survey, Upper Extremities (Finding Present) |
Example upper-extremities examination with a coded abnormal finding. |
| Observation - Triage Acuity Reassessment |
Example standalone triage acuity reassessment, distinct from EMPOCEncounter.priority. |
| Observation - Vital Signs Invalid Example |
Invalid vital signs example demonstrating a missing required value. |
| Organization - Nairobi County EMS |
Example emergency medical services provider and dispatch organization. |
| Practitioner - Ambulance Clinician |
Example paramedic involved in ambulance response and emergency handover. |
| Procedure - Endotracheal Intubation |
Example emergency airway procedure performed during transport. |
| Procedure - Invalid Example |
Invalid procedure example demonstrating a missing required code, the specific procedure performed. |