Generated Narrative: CapabilityStatement kenya-eprescription-server Kenya ePrescription Server CapabilityStatement 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 _include _revinclude Operations 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: unspecified Patient 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: unspecified Practitioner 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: unspecified Organization 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: unspecified Encounter 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 Documentation SHALL patient reference SHALL status token SHALL date date Resource Conformance: unspecified MedicationRequest 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: unspecified Medication 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: unspecified MedicationDispense 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: unspecified MedicationAdministration 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 Documentation SHALL patient reference SHALL request reference SHALL effective-time date Resource Conformance: unspecified MedicationStatement 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: unspecified AllergyIntolerance 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: unspecified Condition Base System Profile Condition Profile Conformance SHALL Reference Policy Interaction summary SHALL support read, create, search-type. Search Parameters Conformance Parameter Type Documentation SHALL patient reference SHALL code token SHALL clinical-status token Resource Conformance: unspecified Provenance 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: unspecified EpisodeOfCare 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
Kenya ePrescription Server CapabilityStatement
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.
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.
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.
OAuth 2.0 with SMART on FHIR scopes. All clients must present a valid access token issued by the national HIE identity provider.
Patient resources are read-only on this server; patient registration is managed by the MPI.
Search by national ID or other patient identifier
Core ePrescription resource. Servers SHALL support create, read, update, and search by patient, requester, status, and authored date.
Filter dispenses by originating prescription
Search by allergen substance code (ActiveComponentsVS)
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.
Filter provenance records by the target medication resource (MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement)
Filter provenance records by the date the record was created
Filter provenance records by the responsible actor (prescriber, pharmacist, or system)