Kenya eClaims FHIR Implementation Guide, published by Digital Health Agency of Kenya. This guide is not an authorized publication; it is the continuous build for version 0.1.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-eClaims-FHIR-IG/ and changes regularly. See the Directory of published versions
Background
Background
Kenya's Health Financing Landscape
Kenya has approximately 56 million people served by a pluralistic health system spanning national referral hospitals, county-level facilities, faith-based organizations, and private providers. Health services are financed through a combination of government budgets, out-of-pocket payments, and health insurance. Prior to the introduction of Universal Health Coverage (UHC), only an estimated 20% of Kenyans had any form of formal health insurance.
The Social Health Insurance Act (2023) repealed the National Hospital Insurance Fund (NHIF) Act and established two successor bodies:
- Social Health Authority (SHA) — The statutory insurer responsible for managing the Social Health Insurance Fund (SHIF), the Emergency, Chronic, and Critical Illness Fund (ECCIF), and the Primary Healthcare Fund (PHCF).
- Social Health Insurance Fund (SHIF) — The pooled fund into which contributions flow and against which claims are adjudicated.
SHA's mandate covers all Kenyans under a contributory scheme, with subsidized cover for informal sector workers and the vulnerable. This represents a fundamental shift from NHIF's facility-based, flat-rate reimbursement to a benefits-package-driven, provider-payment model that requires granular, structured clinical and financial data.
The Electronic Claims Challenge
Healthcare providers across Kenya use diverse Electronic Medical Record (EMR) and Hospital Management Information System (HMIS) platforms, including:
- KenyaEMR (OpenMRS-based)
- Afya Community Health Information Systems
- Various proprietary hospital management systems
- Paper-based registers at lower-level facilities
Without a standardized electronic claims interface, providers rely on paper forms, PDF attachments, or proprietary API integrations to submit claims. This results in:
| Problem |
Impact |
| Data heterogeneity |
Inconsistent diagnosis coding, drug naming, and service categorization |
| Delayed adjudication |
Manual processing backlogs extending reimbursement cycles beyond 90 days |
| Fraud and abuse |
Limited auditability of unbundled or inflated claims |
| Duplicate submissions |
No shared claim identifier standard across payers |
| Limited analytics |
Inability to aggregate utilization data for strategic purchasing |
This Implementation Guide addresses these challenges by providing a single, FHIR-based data standard that all EMRs and payers can implement to exchange claims data consistently.
The Digital Health Agency's Role
The Digital Health Agency (DHA) of Kenya, established under the Kenya Digital Health Act 2023, is responsible for:
- Developing, publishing, and maintaining Kenya's National Health Information Interoperability Framework (NHIIF)
- Operating the Kenya Health Information Exchange (HIE)
- Curating the Open Concept Lab (OCL) terminology repository (
ilm-hie.dha.go.ke)
- Publishing FHIR Implementation Guides for priority health domains
The Kenya eClaims FHIR IG is published by DHA in close collaboration with:
- The Social Health Authority (SHA) — as the primary claims payer and rules authority
- IntelliSOFT Consulting — as technical IG development partner
- The Ministry of Health's Division of Health Financing — for policy alignment
- County Health Management Teams — representing provider interests
- EMR vendors and integration partners — for implementer feasibility
Policy and Legislative Framework
This Implementation Guide is grounded in the following policies and legislation:
| Instrument |
Relevance |
| Kenya Digital Health Act, 2023 |
Mandates interoperability standards for all digital health systems; establishes DHA as the standards authority |
| Social Health Insurance Act, 2023 |
Creates SHA, defines contribution and benefits structures, and mandates electronic claims submission |
| Kenya Health Policy 2014–2030 |
Sets the strategic direction for UHC, preventive care, and health system strengthening |
| Kenya National eHealth Policy 2016–2030 |
Guides investment in health IT infrastructure and data governance |
| Data Protection Act, 2019 |
Governs collection, storage, and processing of personal health data |
| Kenya Medical Records Act |
Defines legal requirements for health record keeping |
| WHO Global Digital Health Strategy 2020–2025 |
International alignment framework for national digital health investments |
SHA Claims Ecosystem
The SHA eClaims ecosystem operates across a tiered architecture:
Level 1 – Point of Care (Provider)
Facilities capture clinical encounters, diagnoses, medications, and procedures in their EMR. The EMR packages this data as a FHIR Bundle containing a Claim, relevant Patient, Encounter, Condition, Coverage, and supporting resources.
Level 2 – Interoperability Layer
The Kenya Health Information Exchange (HIE) validates, routes, and transforms messages. It enforces this FHIR IG's conformance rules, resolves patient identifiers via the Master Patient Index (MPI), and forwards valid claims to SHA's adjudication engine.
Level 3 – SHA Adjudication Engine
SHA's core system evaluates the claim against the member's active coverage, the SHA benefits package (interventions catalogue), and clinical appropriateness rules. It returns a ClaimResponse or requests preauthorization via the preauthorization workflow.
Level 4 – Payment & Reconciliation
Approved claims trigger payment events notified to providers via PaymentNotice resources. Providers reconcile payments against submitted claims using claim identifiers defined in this IG.
Relationship to International Standards
This IG aligns with the following international standards and frameworks:
| Standard |
Usage |
| HL7 FHIR R4 |
Base specification for all resource definitions |
| ICD-11 (WHO) |
Primary diagnosis coding system referenced in ClaimDiagnosisCodeableConceptCS |
| LOINC |
Laboratory and diagnostic report codes in DiagnosticReport.code |
| HL7 Terminology (THO) |
Reused for claim types, encounter classes, and administrative codes |
| MOH-Kenya OCL |
Primary source for Kenya-specific value sets (identifiers, coverage, episode types, etc.) |
| SHA Interventions Catalogue |
Service codes used in Claim.item.productOrService |
SNOMED CT is not used in this IG. All coded elements that would typically reference SNOMED CT (e.g., body sites, medication administration methods, clinical findings) are bound to local Kenya-specific code systems or HL7 terminology equivalents.
Dependencies
Package hl7.fhir.uv.extensions.r4#5.2.0
This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)
|
Package hl7.fhir.uv.extensions.r4#5.3.0
This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, May 16, 2026 18:32+1000+10:00)
|
Package hl7.fhir.uv.tools.r4#1.1.2
This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Mar 24, 2026 11:13+1100+11:00)
|
Cross-Version Analysis
This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (fhir.kenyaClaimsIG.r4) and R4B (fhir.kenyaClaimsIG.r4b) are available.
Global Profiles
There are no Global profiles defined
IP Statements
This publication includes IP covered under the following statements.
- HL7 Inc.
Show Usage
- HL7 International.
Show Usage
- These codes are excerpted from Digital Imaging and Communications in Medicine (DICOM) Standard, Part 16: Content Mapping Resource, Copyright © 2011 by the National Electrical Manufacturers Association.
Show Usage
- These codes have been appropriated from the UB04 code set
owned and managed by the AHA
. Users require a license from the AHA
in order to use these codes. Note: the codes have been withdrawn in a later version
Show Usage
- Example Diagnosis on Admission Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Revenue Center Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- This is an example set based on ASTM Standard, E1762-95 (2013) HL7 RoleClass OID 2.16.840.1.113883.5.110, HL7 Role Code 2.16.840.1.113883.5.111, HL7 ParticipationType OID: 2.16.840.1.113883.5.90, HL7 ParticipationFunction codes at OID: 2.16.840.1.113883.5.88, and HL7 Security and Privacy Domain Analysis Model roles classes.
Show Usage
- This is an example set.
Show Usage
- ICD-10 Procedure Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Adjudication Value Codes: ClaimResponse/8e0e3d44-4b7a-47d6-8b82-39fa646f8088, ClaimResponse/fd876fab-979d-4adb-8b32-46dff643b89f and EClaimsClaimResponse
- Adjudication Error Codes: ClaimResponseAdjudicationErrorVS and EClaimsClaimResponse
- Adjudication Reason Codes: EClaimsClaimResponse
- Exception Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Claim Information Category Codes: Claim/CR-00001, EclaimsResponse... Show 7 more, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Coverage Copay Type Codes: EclaimsCoverage
- Benefit Category Codes: Claim/ECLM-CB-001, Claim/ECLM-IMG-001... Show 13 more, Claim/ECLM-ONC-001, Claim/ECLM-OPT-001, Claim/ECLM-REN-001, Claim/ECLM-SUB-001, Claim/ECLM-SUR-001, EclaimsResponse, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Claim SubType Codes: EClaimsClaimResponse
- Example Coverage Financial Exception Codes: EclaimsCoverage
- Example Diagnosis Related Group Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Diagnosis Type Codes: Claim/CR-00001, EclaimsResponse... Show 7 more, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Payment Type Codes: EClaimsClaimResponse
- Example Procedure Type Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Program Reason Codes: EClaimsClaimResponse, EclaimsResponse... Show 7 more, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Example Service Place Codes: EClaimsClaimResponse, EclaimsResponse... Show 7 more, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Form Codes: ClaimResponseFormsVS and EClaimsClaimResponse
- Funds Reservation Codes: ClaimResponseFundsReserveVS, EClaimsClaimResponse... Show 8 more, EclaimsResponse, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Missing Tooth Reason Codes: EclaimsResponse, KenyaClaimBase... Show 6 more, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Modifier type Codes: EClaimsClaimResponse, EclaimsResponse... Show 7 more, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Claim Payee Type Codes: Claim/CR-00001, Claim/ECLM-CB-001... Show 16 more, Claim/ECLM-IMG-001, Claim/ECLM-ONC-001, Claim/ECLM-OPT-001, Claim/ECLM-REN-001, Claim/ECLM-SUB-001, Claim/ECLM-SUR-001, ClaimResponsePayeeTypeVS, EClaimsClaimResponse, EclaimsResponse, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- Payment Adjustment Reason Codes: EClaimsClaimResponse
- Payment Status Codes: EClaimsPaymentNotice and PaymentNotice/ECLM-PN-001
- Process Priority Codes: Claim/CLAIM-0000X, Claim/CR-00001... Show 17 more, Claim/ECLM-CB-001, Claim/ECLM-IMG-001, Claim/ECLM-ONC-001, Claim/ECLM-OPT-001, Claim/ECLM-REN-001, Claim/ECLM-SUB-001, Claim/ECLM-SUR-001, Claim/a7dcd571-d8a2-483a-8a45-e3c8bcbff8b8, Claim/ae044c1d-9ecb-4294-be9b-0702e7892596, EclaimsResponse, KenyaClaimBase, KenyaClaimSubmission, KenyaImagingPreauth, KenyaOncologyPreauth, KenyaOpticalPreauth, KenyaRenalPreauth and KenyaSurgicalPreauth
- This is an extensible set.
Show Usage
- This material contains content from LOINC. LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
Show Usage
- This material contains content that is copyright of SNOMED International. Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/get-snomed or info@snomed.org.
Show Usage