Kenya Core Implementation Guide
1.0.0 - release Kenya flag

Kenya Core Implementation Guide, published by Digital Health Agency (DHA), Kenya. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IntelliSOFT-Consulting/Kenya-core-FHIR-IG/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

Kenya Core AllergyIntolerance Profile

Allergy or intolerance record.

Kenya Core Communication Profile

Kenya Core profile for recording a communication that has occurred between a patient, care team members, and/or systems, e.g. referral follow-up calls, SMS notifications, care coordination messages.

Kenya Core CommunicationRequest Profile

Kenya Core profile for a request to convey information, e.g. a request to notify a patient of results, or to arrange a follow-up call.

Kenya Core Consent Profile

Kenya Core profile for recording a patient's consent, e.g. consent to treatment, consent to data sharing with the Social Health Authority, or consent to research.

Kenya Core DetectedIssue Profile

Kenya Core profile for recording a clinical issue detected during care provision, e.g. drug interaction, duplicate therapy, allergy conflict identified by clinical decision support.

Kenya Core Device Profile

Kenya Core profile for a physical medical device (equipment, appliance, implant, monitor, etc.) used in the provision of care.

Kenya Core DiagnosticReport Profile

DiagnosticReport profile for Kenya Core.

Kenya Core DocumentReference Profile

DocumentReference profile for Kenya Core.

Kenya Core Encounter Profile

Kenya Core FHIR profile for Encounter resource, aligned with Kenya Core specifications.

Kenya Core EpisodeOfCare Profile

An association between a patient and an organization / healthcare provider during which time encounters may occur and healthcare services are provided.

Kenya Core Location Profile

Location profile for facility units, wards, labs.

Kenya Core Measure Profile

Kenya Core profile for a quality/performance Measure definition, e.g. HIV viral suppression rate, ANC 4th visit coverage, used for reporting to the Social Health Authority and MOH.

Kenya Core MeasureReport Profile

Kenya Core profile for the results of calculating a Measure over a period, at either an individual or a population/summary level, e.g. facility monthly indicator reports submitted to SHA.

Kenya Core Observation Profile

Observation profile for vitals and lab results.

Kenya Core OperationOutcome Profile

Kenya Core profile for OperationOutcome, used to report the outcome of an operation, typically errors, warnings, or informational messages returned by a system when processing a request.

Kenya Core Procedure Profile

Procedure profile for clinical and surgical procedures.

Kenya Core Provenance Profile

Kenya Core profile for Provenance, used to track the origin, authorship, and handling of clinical and administrative resources exchanged within Kenya FHIR implementation guides.

Kenya Core QuestionnaireResponse Profile

QuestionnaireResponse profile for Kenya Core.

Kenya Core RelatedPerson Profile

RelatedPerson used for next-of-kin, caregivers.

Kenya Core ServiceRequest Profile

Kenya Core base profile for a request for a service (lab order, referral, imaging order, procedure order, etc). Intended to be reused and further constrained by other Kenya implementation guides.

Kenya Core Task Profile

Kenya Core base profile for a Task representing a piece of work to be performed in a clinical or administrative workflow, e.g. referral coordination, order fulfilment tracking. Intended to be reused and further constrained by other Kenya implementation guides.

KenyaCore Condition Profile

Condition/diagnosis profile; bind to ICD/SNOMED where appropriate.

KenyaCore Organization Profile

Organization representing healthcare provider facilities in Kenya.

KenyaCore Patient Profile

This profile represents the constraints applied to the Patient resource based on the International Patient Summary (IPS) FHIR Implementation Guide. It describes the minimum expectations for the Patient resource when used in the IPS composition or as a referenced resource.

KenyaCore Practitioner Profile

Practitioner profile for Kenya healthcare providers

KenyaCore PractitionerRole Profile

PractitionerRole linking practitioners to organizations and roles.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Approval Status Extension

Extension to capture the regulatory approval status of a healthcare facility.

Facility Level Extension

Extension to capture the service level (e.g. Level 2 - Level 6B) of a healthcare facility.

License Status Extension

Extension to capture the status (active/inactive) of a practitioner's professional license.

Licensing Body Extension

Extension to capture the Kenyan regulatory body that issued a practitioner's professional qualification.

Patient Ethnicity Extension

Extension to capture patient ethnicity using a CodeableConcept from NZ ethnic-group-level-4 code system.

Person With Disability Extension

Extension to indicate if a person has a disability.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Active Components ValueSet

Active pharmaceutical ingredient codes drawn from the MOH PPB active components code system.

Administrative Gender Value Set

Administrative Gender Value Set

Approval Status Value Set

Approval Status Value Set

Care Plan Category ValueSet

Category codes for care plan types.

Claim Status ValueSet

ValueSet for claim status codes (MOH-Kenya OCL: CLAIM-STATUS)

Claim Type ValueSet

ValueSet for claim type codes (MOH-Kenya OCL: CLAIM-TYPE)

Claim Use ValueSet

ValueSet for intended use of a claim (MOH-Kenya OCL: CLAIM-USE)

Condition Category Value Set

A value set that includes categories for conditions.

Condition Clinical Status Value Set

A value set that includes clinical status codes for conditions.

Condition Codes ValueSet

Codes for clinical conditions and diagnoses. References ICD-10 pending population of the MOH-KENYA CONDITION-CODES OCL collection.

Condition Severity ValueSet

Severity codes for Condition resources.

Condition Verification Status Value Set

A value set that includes verification status codes for conditions.

Coverage Type ValueSet

ValueSet for insurance coverage type codes (MOH-Kenya OCL: COVERAGE-TYPE)

Encounter Status Value Set

Encounter Status Value Set

Encounter Type Value Set

Encounter Type Value Set

Episode of Care Status Value Set

Episode of Care Status Value Set

Episode of Care Type Value Set

Episode of Care Type Value Set

Facility Level Value Set

Facility Level Value Set

Generic Products ValueSet

Generic medicinal product codes drawn from the MOH PPB generic products code system.

ICD-11 Codes ValueSet

All codes from the WHO International Classification of Diseases, 11th Revision (ICD-11).

Kenya License Status Value Set

Kenya License Status Value Set

Kenya Regulatory Body Value Set

Kenya Regulatory Body Value Set

Location Type Value Set

Location Types Value Set

Manifestation or Symptom ValueSet

Clinical manifestations and symptoms.

Medication Administration Route ValueSet

Route of administration codes for MedicationAdministration, sourced from MOH PPB OCL RouteOfAdministration collection. Replaces SNOMED CT route-codes binding from base FHIR R4.

Medication Request Priority ValueSet

ValueSet for priority levels in the MedicationRequest workflow.

MedicationAdministration Status Reason ValueSet

Reasons for a MedicationAdministration status.

MedicationRequest Status Reason ValueSet

Reasons for a MedicationRequest status change.

MedicationRequest Status ValueSet

ValueSet containing status codes for MedicationRequest.

National ID Value Set

National ID Value Set

Nationality Value Set

Nationality Value Set

Organization Type Value Set

Value set for organization types in Kenya Core FHIR IG

Practitioner Registration Number Value Set

Practitioner Registration Number Value Set

Practitioner Registry ID Value Set

Practitioner Registry ID Value Set

Practitioner Roles Value Set

Practitioner Roles Value Set

Practitioner Specialties Value Set

Practitioner Specialties Value Set

Procedure Code ValueSet

Clinical procedure codes for care plan activities and service requests.

Related Person Relationship Value Set

Related Person Relationship Value Set

Route of Administration ValueSet

Codes for route of administration of medications, drawn from the MOH PPB route of administration code system.

Slade Code Value Set

Slade Code Value Set

Source of Referral Value Set

Indicates the source from which a client was referred: community, health provider, or self-referral.

Unit of Measure ValueSet

Codes for units of measure used in medication dosing, drawn from the MOH PPB unit of measure code system.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Active Components CodeSystem

Active pharmaceutical ingredient codes from MOH PPB OCL.

Approval Status

Approval Status Code Systems

Care Plan Category CodeSystem

Category codes for care plan types. Source: MOH-KENYA OCL CARE-PLAN-CATEGORY.

Claim Status Code System

Codes for the status of a claim. Codes align with FHIR fm-status to allow required binding as a subset.

Claim Type Code System

Codes for the type of claim. Codes align with FHIR claim-type to allow required binding as a subset.

Claim Use Code System

Codes for the intended use of a claim. Codes align with FHIR claim-use to allow required binding as a subset.

Condition Category Code System

A code system that defines categories for conditions.

Condition Clinical Status Code System

A code system that defines clinical status for conditions.

Condition Severity CodeSystem

Severity codes for Condition resources. Source: MOH-KENYA OCL CONDITION-SEVERITY.

Condition Verification Status Code System

A code system that defines verification status for conditions.

Country Codes

A code system representing country codes.

Coverage Type Code System

Codes for the type of insurance coverage (MOH-Kenya OCL: COVERAGE-TYPE)

Encounter Status Code System

A code system that defines the status of an encounter.

Encounter Type Code System

A code system that defines types of encounters.

Episode of Care Status Code System

A code system that defines the status of an episode of care.

Episode of Care Type Code System

A code system that defines types of episodes of care.

Facility Identifier Types

Facility Identifier Types Code Systems

Facility Level

Facility Level Code Systems

Generic Products CodeSystem

Generic medicinal product codes from MOH PPB OCL.

ICD-11 Code System

ICD-11 codes for mortality and morbidity statistics. Source: MOH-KENYA OCL ICD-11-FOR-MORTALITY-AND-MORBIDITY-STATISTICS.

Kenya License Status

Kenya License Status Code Systems

Kenya Regulatory Body

Kenya Regulatory Body Code System

Location Type

Location Type Code Systems

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 CodeSystem

Route of administration codes used in MedicationAdministration. Source: MOH PPB OCL RouteOfAdministration collection (https://ilm-hie.dha.go.ke/ocl/orgs/MOH-PPB/ValueSet/RouteOfAdministration/$expand).

Medication Request Priority CodeSystem

Codes representing priority levels for MedicationRequest.

MedicationAdministration Status Reason CodeSystem

Reasons for a MedicationAdministration status (e.g. patient refused, not available). Source: MOH-KENYA OCL MEDICATION-ADMIN-STATUS-REASON.

MedicationRequest Status CodeSystem

Status codes used for MedicationRequest resources.

MedicationRequest Status Reason CodeSystem

Reasons for a MedicationRequest status change (e.g. cancelled, on-hold). Source: MOH-KENYA OCL MEDICATIONREQUEST-STATUS-REASON.

Organisation Type

Auto-released v20251217120809

Practitioner Roles Code System

Practitioner Roles Code System

Practitioner Specialities Code System

Practitioner Specialities Code Systems

Procedure Code CodeSystem

Clinical procedure codes used in care plan activities and service requests. Source: MOH-KENYA OCL PROCEDURE-CODE.

Referral Source Code System

Codes for the source from which a client was referred (community, health provider, or self-referral).

Related Person Relationship Code System

A code system that defines relationships for related persons.

Route of Administration CodeSystem

Route of administration codes from MOH PPB OCL.

Unit of Measure CodeSystem

Unit of measure codes from MOH PPB OCL.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Example AllergyIntolerance - Penicillin Allergy

Example allergy record for Amina Hassan.

Example Communication - Lab Result Notification Call

Example record of a phone call notifying Amina Hassan that her lab results are ready.

Example CommunicationRequest - Request to Notify of Results

Example request for the care team to notify Amina Hassan once her lab results are available.

Example Condition - Iron Deficiency Anaemia

Example diagnosis recorded for Amina Hassan during her outpatient visit.

Example Consent - Data Sharing with SHA

Example patient consent authorizing sharing of clinical data with the Social Health Authority.

Example DetectedIssue - Duplicate Therapy Alert

Example clinical decision support alert flagging a duplicate therapy for Amina Hassan.

Example Device - Infusion Pump

Example infusion pump device owned by Kenyatta National Hospital.

Example DiagnosticReport - Full Haemogram

Example laboratory diagnostic report summarising Amina Hassan's full haemogram results.

Example DocumentReference - Lab Report PDF

Example document reference pointing to a scanned/printable copy of Amina Hassan's full haemogram report.

Example Encounter - Amina Hassan Outpatient Visit

Example outpatient encounter used as context for other Kenya Core examples.

Example EpisodeOfCare - Outpatient Care Episode

Example episode of care for Amina Hassan's ongoing outpatient management.

Example Location - KNH Outpatient Clinic

Example clinic location used as context for other Kenya Core examples.

Example Measure - Fourth Antenatal Care Visit Coverage

Example quality measure tracking the proportion of pregnant clients completing a fourth antenatal care visit.

Example MeasureReport - ANC4 Coverage, August 2026

Example facility-level summary report of ANC4 coverage submitted by Kenyatta National Hospital.

Example Observation - Haemoglobin Result

Example laboratory result observation for Amina Hassan's full haemogram.

Example OperationOutcome - Invalid Patient Identifier

Example error response returned when a submitted Patient resource is missing a required identifier.

Example Organization - Kenyatta National Hospital

Example provider organization used as the actor in other Kenya Core examples.

Example Patient - Amina Hassan

Example patient used as subject in other Kenya Core examples.

Example Practitioner - Dr Sarah Njoroge

Example practitioner used as requester/author/agent in other Kenya Core examples.

Example PractitionerRole - Dr Njoroge at KNH

Example role linking Dr Sarah Njoroge to Kenyatta National Hospital.

Example Procedure - Venepuncture

Example procedure record for the blood draw supporting Amina Hassan's full haemogram.

Example Provenance - ServiceRequest Authorship

Example provenance record describing the creation of the example ServiceRequest by Dr Sarah Njoroge.

Example QuestionnaireResponse - Intake Form

Example completed intake questionnaire for Amina Hassan.

Example RelatedPerson - Amina's Next of Kin

Example next-of-kin contact for Amina Hassan.

Example ServiceRequest - Full Haemogram Lab Order

Example lab order requesting a full haemogram for Amina Hassan.

Example Task - Fulfil Lab Order

Example workflow task tracking fulfilment of the example ServiceRequest by the KNH laboratory.