Kenya ePrescription Server CapabilityStatement

Kenya ePrescription Implementation Guide, published by Digital Health Agency (DHA), 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-ePrescription-IG/ and changes regularly. See the Directory of published versions

CapabilityStatement: Kenya ePrescription Server CapabilityStatement

Official URL: https://fhir.dha.go.ke/fhir/CapabilityStatement/kenya-eprescription-server				Version: 0.1.0
Active as of 2025-06-01				Computable Name: KenyaEPrescriptionServerCapabilityStatement
Copyright/Legal: Copyright 2025+ Digital Health Agency, Kenya. This content is licensed under Creative Commons Attribution 4.0 International (CC-BY-4.0). Terminology content from the Kenya Pharmacy and Poisons Board (PPB) via Open Concept Lab (OCL) is subject to separate terms.

This CapabilityStatement defines the conformance requirements for any system claiming to be a Kenya ePrescription server. It covers the core prescription-to-dispense workflow as well as oncology care plan and allergy management capabilities.

Raw OpenAPI-Swagger Definition file | Download

Implementation Guide Version: 0.1.0
FHIR Version: 4.0.1
Supported Formats: json, xml
Published on: 2025-06-01
Published by: Digital Health Agency (DHA), Kenya

Note to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: `server`

The Kenya ePrescription server supports resource-level CRUD operations and the search interactions listed below. All transactions must be authenticated via OAuth 2.0 / SMART on FHIR.

Security

Enable CORS: yes

Security services supported: SMART-on-FHIR

OAuth 2.0 with SMART on FHIR scopes. All clients must present a valid access token issued by the national HIE identity provider.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

The relevant profiles (if any)
The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
The required, recommended, and some optional search parameters (if any).
The linked resources enabled for _include
The other resources enabled for _revinclude
The operations on the resource (if any)

Resource Type	Profile	R	S	U	C	Searches
Patient	http://hl7.org/fhir/StructureDefinition/Patient	Y	Y			identifier, name, birthdate
Practitioner	http://hl7.org/fhir/StructureDefinition/Practitioner	Y	Y			identifier
Organization	http://hl7.org/fhir/StructureDefinition/Organization	Y	Y			identifier
Encounter	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-encounter	Y	Y	Y	Y	patient, status, date
MedicationRequest	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-request	Y	Y	Y	Y	patient, requester, status, authoredon, medication, identifier
Medication	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication	Y	Y			code
MedicationDispense	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-dispense	Y	Y	Y	Y	patient, prescription, status, whenhandedover
MedicationAdministration	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-administration	Y	Y		Y	patient, request, effective-time
MedicationStatement	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-statement	Y	Y		Y	patient, status
AllergyIntolerance	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-allergy-intolerance	Y	Y	Y	Y	patient, clinical-status, code
Condition	http://hl7.org/fhir/StructureDefinition/Condition	Y	Y		Y	patient, code, clinical-status
Provenance	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-provenance	Y	Y		Y	target, recorded, agent
EpisodeOfCare	https://fhir.dha.go.ke/fhir/StructureDefinition/ke-episode-of-care	Y	Y		Y	patient, status

Resource Conformance: unspecifiedPatient

Base System Profile
Patient

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Patient resources are read-only on this server; patient registration is managed by the MPI.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Search by national ID or other patient identifier
SHALL	name	`string`
SHALL	birthdate	`date`

Resource Conformance: unspecifiedPractitioner

Base System Profile
Practitioner

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Search by KMPDC medical licence number

Resource Conformance: unspecifiedOrganization

Base System Profile
Organization

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read.
SHOULD support search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Search by MFL facility code

Resource Conformance: unspecifiedEncounter

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-encounter

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create, update, search-type.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	status	`token`
SHALL	date	`date`

Resource Conformance: unspecifiedMedicationRequest

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-request

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create, update, search-type.

Documentation

Core ePrescription resource. Servers SHALL support create, read, update, and search by patient, requester, status, and authored date.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Search prescriptions by patient
SHALL	requester	`reference`
SHALL	status	`token`
SHALL	authoredon	`date`
SHALL	medication	`token`
SHALL	identifier	`token`

Resource Conformance: unspecifiedMedication

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read.
SHOULD support search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	code	`token`	Search by PPB generic product code

Resource Conformance: unspecifiedMedicationDispense

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-dispense

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create, update, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	prescription	`reference`	Filter dispenses by originating prescription
SHALL	status	`token`
SHALL	whenhandedover	`date`

Resource Conformance: unspecifiedMedicationAdministration

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-administration

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create.
SHOULD support search-type.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	request	`reference`
SHALL	effective-time	`date`

Resource Conformance: unspecifiedMedicationStatement

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-medication-statement

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	status	`token`

Resource Conformance: unspecifiedAllergyIntolerance

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-allergy-intolerance

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create, update, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	clinical-status	`token`
SHALL	code	`token`	Search by allergen substance code (ActiveComponentsVS)

Resource Conformance: unspecifiedCondition

Base System Profile
Condition

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create, search-type.

Search Parameters

Conformance	Parameter	Type
SHALL	patient	`reference`
SHALL	code	`token`
SHALL	clinical-status	`token`

Resource Conformance: unspecifiedProvenance

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-provenance

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, create.
SHOULD support search-type.

Documentation

Audit trail resource capturing authorship and lifecycle changes to prescriptions, dispenses, and administration records. Servers SHALL support read and create; search by target is SHOULD.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	target	`reference`	Filter provenance records by the target medication resource (MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement)
SHALL	recorded	`date`	Filter provenance records by the date the record was created
SHALL	agent	`reference`	Filter provenance records by the responsible actor (prescriber, pharmacist, or system)

Resource Conformance: unspecifiedEpisodeOfCare

Base System Profile
https://fhir.dha.go.ke/fhir/StructureDefinition/ke-episode-of-care

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read.
SHOULD support create, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	status	`token`

CapabilityStatement: Kenya ePrescription Server CapabilityStatement