SMART Base
0.2.0 - ci-build

SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/tree/mar2026 and changes regularly. See the Directory of published versions
Built from commit 2f4cdd50.   Branch: mar2026.

DAK API Documentation Hub

DAK API Documentation Hub

This page provides access to Data Access Kit (DAK) API documentation and schemas.

Table of Contents

  1. DAK API Documentation Hub

API Enumeration Endpoints

These endpoints provide lists of all available schemas and vocabularies of each type:

ValueSets.schema.json

Enumeration of all available ValueSet schemas

Available Endpoints:

LogicalModels.schema.json

Enumeration of all available Logical Model schemas

Available Endpoints:

ValueSet Schemas (22 available)

JSON Schema definitions for FHIR ValueSets, providing structured enumeration of allowed code values:

Digital Health Interventions for Healthcare Providers Schema

JSON Schema for Digital Health Interventions for Healthcare Providers ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions for Persons Schema

JSON Schema for Digital Health Interventions for Persons ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions for Health Management and Support Personnel Schema

JSON Schema for Digital Health Interventions for Health Management and Support Personnel ValueSet codes. Generated from FHIR expansions using IRI format.

Health System Challenges Schema

JSON Schema for Health System Challenges ValueSet codes. Generated from FHIR expansions using IRI format.

SMART Guidelines Authoring Persona Types ValueSet Schema

JSON Schema for SMART Guidelines Authoring Persona Types ValueSet ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions for Health Workers Schema

JSON Schema for Digital Health Interventions for Health Workers ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types: Data Management Services Schema

JSON Schema for Services and Application Types: Data Management Services ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types: Registries and Directories Schema

JSON Schema for Services and Application Types: Registries and Directories ValueSet codes. Generated from FHIR expansions using IRI format.

Classification of Digital Health Interventions v1 Schema

JSON Schema for Classification of Digital Health Interventions v1 ValueSet codes. Generated from FHIR expansions using IRI format.

Core Data Element Type Value Set Schema

JSON Schema for Core Data Element Type Value Set ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions for Health System Managers Schema

JSON Schema for Digital Health Interventions for Health System Managers ValueSet codes. Generated from FHIR expansions using IRI format.

SMART Guidelines Authoring Skills ValueSet Schema

JSON Schema for SMART Guidelines Authoring Skills ValueSet ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types: Point of Service Schema

JSON Schema for Services and Application Types: Point of Service ValueSet codes. Generated from FHIR expansions using IRI format.

Smart Guidelines Persona Types Value Set Schema

JSON Schema for Smart Guidelines Persona Types Value Set ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions: Data Services Schema

JSON Schema for Digital Health Interventions: Data Services ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions for Clients Schema

JSON Schema for Digital Health Interventions for Clients ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types: Health System/Provider Administration Schema

JSON Schema for Services and Application Types: Health System/Provider Administration ValueSet codes. Generated from FHIR expansions using IRI format.

Digital Health Interventions: Data Services Schema

JSON Schema for Digital Health Interventions: Data Services ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types Schema

JSON Schema for Services and Application Types ValueSet codes. Generated from FHIR expansions using IRI format.

Smart Guidelines Decision Table Actions Schema

JSON Schema for Smart Guidelines Decision Table Actions ValueSet codes. Generated from FHIR expansions using IRI format.

Services and Application Types: Surveillance and Response Schema

JSON Schema for Services and Application Types: Surveillance and Response ValueSet codes. Generated from FHIR expansions using IRI format.

Classification of Digital Health Interventions v2 Schema

JSON Schema for Classification of Digital Health Interventions v2 ValueSet codes. Generated from FHIR expansions using IRI format.

Logical Model Schemas (25 available)

JSON Schema definitions for FHIR Logical Models, defining structured data elements and their relationships:

Decision-Support Logic (DAK)

Logical Model for representing Decision-Support Logic from a DAK. Decision-support logic and algorithms to support appropriate service delivery in accordance with WHO clinical, public health and data use guidelines.

Dublin Core Metadata Element Set

Logical Model representing Dublin Core metadata elements as defined at https://www.dublincore.org/specifications/dublin-core/dcmi-terms/

Business Process Workflow Source

Source reference for Business Process Workflow - exactly one of the following must be provided: - url (url data type): URL to retrieve BusinessProcessWorkflow definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the BusinessProcessWorkflow definition - instance: Inline BusinessProcessWorkflow instance data

User Scenario Source

Source reference for User Scenario - exactly one of the following must be provided: - url (url data type): URL to retrieve UserScenario definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the UserScenario definition - instance: Inline UserScenario instance data

Health Interventions and Recommendations (DAK)

Logical Model for representing Health Interventions and Recommendations from a DAK. Overview of the health interventions and WHO, regional or national recommendations included within the DAK.

FHIR Schema Base (SMART Guidelines)

Base logical model providing the common schema metadata interface inherited by all SMART Guidelines logical models. Every SMART Guidelines logical model schema derives from this base, which documents the shared FHIR and JSON-LD metadata properties used by the JSON Schema generation pipeline.

Core Data Element (DAK)

Logical Model for representing Core Data Elements from a DAK. A core data element can be one of: a ValueSet, a CodeSystem, a ConceptMap, or a Logical Model adherent to SGLogicalModel. This is the ONE EXCEPTION to allowing FHIR R4 models into the DAK LMs.

Business Process Workflow (DAK)

Logical Model for representing Generic Business Processes and Workflows from a DAK. A business process is a set of related activities or tasks performed together to achieve the objectives of the health programme area.

Functional and Non-Functional Requirements (DAK)

Logical Model for representing Functional and Non-Functional Requirements from a DAK. A high-level list of core functions and capabilities that the system must have to meet the end users' needs.

Test Scenario Source

Source reference for Test Scenario - exactly one of the following must be provided: - url (url data type): URL to retrieve TestScenario definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the TestScenario definition - instance: Inline TestScenario instance data

Test Scenario (DAK)

Logical Model for representing Test Scenarios from a DAK. A set of test scenarios to validate an implementation of the DAK.

User Scenario (DAK)

Logical Model for representing User Scenarios from a DAK. Narratives that describe how the different personas may interact with each other.

Decision Support Logic Source

Source reference for Decision Support Logic - exactly one of the following must be provided: - url (url data type): URL to retrieve DecisionSupportLogic definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the DecisionSupportLogic definition - instance: Inline DecisionSupportLogic instance data

Non-Functional Requirement (DAK)

Logical Model for representing non-functional requirement from a DAK

Health Interventions Source

Source reference for Health Interventions - exactly one of the following must be provided: - url (url data type): URL to retrieve HealthInterventions definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the HealthInterventions definition - instance: Inline HealthInterventions instance data

Program Indicator Source

Source reference for Program Indicator - exactly one of the following must be provided: - url (url data type): URL to retrieve ProgramIndicator definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the ProgramIndicator definition - instance: Inline ProgramIndicator instance data

SUSHI Configuration Logical Model

Logical model defining the structure of sushi-config.yaml files used for FHIR Implementation Guide configuration. This model captures the essential metadata and configuration parameters needed for IG publishing.

Functional Requirement (DAK)

Logical Model for representing functional requirement from a DAK

Digital Adaptation Kit (DAK)

Logical Model for representing a complete Digital Adaptation Kit (DAK) with metadata and all 9 DAK components

Generic Persona Source

Source reference for Generic Persona - exactly one of the following must be provided: - url (url data type): URL to retrieve GenericPersona definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the GenericPersona definition - instance: Inline GenericPersona instance data

Persona (DAK)

Logical Model for representing Personas from a DAK

Program Indicator (DAK)

Logical Model for representing Program Indicators from a DAK. Core set of indicators that need to be aggregated for decision-making, performance metrics and subnational and national reporting.

Requirements Source

Source reference for Requirements - exactly one of the following must be provided: - url (url data type): URL to retrieve Requirements definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the Requirements definition - instance: Inline Requirements instance data

Generic Persona (DAK)

Logical Model for representing Generic Personas from a DAK. Depiction of the human and system actors. Human actors are end users, supervisors and related stakeholders who would be interacting with the digital system or involved in the clinical care, public health or health system pathway.

Core Data Element Source

Source reference for Core Data Element - exactly one of the following must be provided: - url (url data type): URL to retrieve CoreDataElement definition from input/ or external source - canonical (canonical data type): Canonical URI pointing to the CoreDataElement definition - instance: Inline CoreDataElement instance data

OpenAPI Documentation

Complete API specification documentation for all available endpoints:

ValueSet-CDHIv2.2 Endpoints

API endpoints for Digital Health Interventions for Healthcare Providers Schema

ValueSet-CDHIv2.1 Endpoints

API endpoints for Digital Health Interventions for Persons Schema

ValueSet-CDHIv2.3 Endpoints

API endpoints for Digital Health Interventions for Health Management and Support Personnel Schema

ValueSet-CDSCv1 Endpoints

API endpoints for Health System Challenges Schema

ValueSet-SGAuthoringPersonaTypesVS Endpoints

API endpoints for SMART Guidelines Authoring Persona Types ValueSet Schema

ValueSet-CDHIv1.2 Endpoints

API endpoints for Digital Health Interventions for Health Workers Schema

ValueSet-CDSCv2.D Endpoints

API endpoints for Services and Application Types: Data Management Services Schema

ValueSet-CDSCv2.C Endpoints

API endpoints for Services and Application Types: Registries and Directories Schema

ValueSet-CDHIv1 Endpoints

API endpoints for Classification of Digital Health Interventions v1 Schema

ValueSet-CoreDataElementTypeVS Endpoints

API endpoints for Core Data Element Type Value Set Schema

ValueSet-CDHIv1.3 Endpoints

API endpoints for Digital Health Interventions for Health System Managers Schema

ValueSet-SGAuthoringSkillsVS Endpoints

API endpoints for SMART Guidelines Authoring Skills ValueSet Schema

ValueSet-CDSCv2.A Endpoints

API endpoints for Services and Application Types: Point of Service Schema

ValueSet-SGPersonaTypesVS Endpoints

API endpoints for Smart Guidelines Persona Types Value Set Schema

ValueSet-CDHIv1.4 Endpoints

API endpoints for Digital Health Interventions: Data Services Schema

ValueSet-CDHIv1.1 Endpoints

API endpoints for Digital Health Interventions for Clients Schema

ValueSet-CDSCv2.B Endpoints

API endpoints for Services and Application Types: Health System/Provider Administration Schema

ValueSet-CDHIv2.4 Endpoints

API endpoints for Digital Health Interventions: Data Services Schema

ValueSet-CDSCv2 Endpoints

API endpoints for Services and Application Types Schema

ValueSet-DecisionTableActions Endpoints

API endpoints for Smart Guidelines Decision Table Actions Schema

ValueSet-CDSCv2.E Endpoints

API endpoints for Services and Application Types: Surveillance and Response Schema

ValueSet-CDHIv2 Endpoints

API endpoints for Classification of Digital Health Interventions v2 Schema

StructureDefinition-DecisionSupportLogic Endpoints

API endpoints for Decision-Support Logic (DAK)

StructureDefinition-DublinCore Endpoints

API endpoints for Dublin Core Metadata Element Set

StructureDefinition-BusinessProcessWorkflowSource Endpoints

API endpoints for Business Process Workflow Source

StructureDefinition-UserScenarioSource Endpoints

API endpoints for User Scenario Source

StructureDefinition-HealthInterventions Endpoints

API endpoints for Health Interventions and Recommendations (DAK)

StructureDefinition-FHIRSchemaBase Endpoints

API endpoints for FHIR Schema Base (SMART Guidelines)

StructureDefinition-CoreDataElement Endpoints

API endpoints for Core Data Element (DAK)

StructureDefinition-BusinessProcessWorkflow Endpoints

API endpoints for Business Process Workflow (DAK)

StructureDefinition-Requirements Endpoints

API endpoints for Functional and Non-Functional Requirements (DAK)

StructureDefinition-TestScenarioSource Endpoints

API endpoints for Test Scenario Source

StructureDefinition-TestScenario Endpoints

API endpoints for Test Scenario (DAK)

StructureDefinition-UserScenario Endpoints

API endpoints for User Scenario (DAK)

StructureDefinition-DecisionSupportLogicSource Endpoints

API endpoints for Decision Support Logic Source

StructureDefinition-NonFunctionalRequirement Endpoints

API endpoints for Non-Functional Requirement (DAK)

StructureDefinition-HealthInterventionsSource Endpoints

API endpoints for Health Interventions Source

StructureDefinition-ProgramIndicatorSource Endpoints

API endpoints for Program Indicator Source

StructureDefinition-SushiConfigLogicalModel Endpoints

API endpoints for SUSHI Configuration Logical Model

StructureDefinition-FunctionalRequirement Endpoints

API endpoints for Functional Requirement (DAK)

StructureDefinition-DAK Endpoints

API endpoints for Digital Adaptation Kit (DAK)

StructureDefinition-GenericPersonaSource Endpoints

API endpoints for Generic Persona Source

StructureDefinition-Persona Endpoints

API endpoints for Persona (DAK)

StructureDefinition-ProgramIndicator Endpoints

API endpoints for Program Indicator (DAK)

StructureDefinition-RequirementsSource Endpoints

API endpoints for Requirements Source

StructureDefinition-GenericPersona Endpoints

API endpoints for Generic Persona (DAK)

StructureDefinition-CoreDataElementSource Endpoints

API endpoints for Core Data Element Source

ValueSets Enumeration Endpoint

Complete list of all available ValueSet schemas

LogicalModels Enumeration Endpoint

Complete list of all available Logical Model schemas

ValueSet-CDHIv2.3 API

OpenAPI specification for ValueSet-CDHIv2.3

ValueSet-CDSCv2.D API

OpenAPI specification for ValueSet-CDSCv2.D

ValueSet-CDSCv2 API

OpenAPI specification for ValueSet-CDSCv2

ValueSet-SGAuthoringPersonaTypesVS API

OpenAPI specification for ValueSet-SGAuthoringPersonaTypesVS

ValueSet-CDHIv1 API

OpenAPI specification for ValueSet-CDHIv1

StructureDefinition-BusinessProcessWorkflowSource API

OpenAPI specification for StructureDefinition-BusinessProcessWorkflowSource

StructureDefinition-ProgramIndicator API

OpenAPI specification for StructureDefinition-ProgramIndicator

StructureDefinition-GenericPersona API

OpenAPI specification for StructureDefinition-GenericPersona

StructureDefinition-NonFunctionalRequirement API

OpenAPI specification for StructureDefinition-NonFunctionalRequirement

ValueSet-CDHIv2.1 API

OpenAPI specification for ValueSet-CDHIv2.1

StructureDefinition-TestScenarioSource API

OpenAPI specification for StructureDefinition-TestScenarioSource

StructureDefinition-SushiConfigLogicalModel API

OpenAPI specification for StructureDefinition-SushiConfigLogicalModel

StructureDefinition-CoreDataElement API

OpenAPI specification for StructureDefinition-CoreDataElement

StructureDefinition-GenericPersonaSource API

OpenAPI specification for StructureDefinition-GenericPersonaSource

ValueSet-CDSCv1 API

OpenAPI specification for ValueSet-CDSCv1

StructureDefinition-UserScenarioSource API

OpenAPI specification for StructureDefinition-UserScenarioSource

ValueSet-CDHIv1.2 API

OpenAPI specification for ValueSet-CDHIv1.2

StructureDefinition-BusinessProcessWorkflow API

OpenAPI specification for StructureDefinition-BusinessProcessWorkflow

StructureDefinition-DecisionSupportLogicSource API

OpenAPI specification for StructureDefinition-DecisionSupportLogicSource

ValueSet-CDSCv2.E API

OpenAPI specification for ValueSet-CDSCv2.E

StructureDefinition-DAK API

OpenAPI specification for StructureDefinition-DAK

StructureDefinition-HealthInterventionsSource API

OpenAPI specification for StructureDefinition-HealthInterventionsSource

StructureDefinition-RequirementsSource API

OpenAPI specification for StructureDefinition-RequirementsSource

StructureDefinition-UserScenario API

OpenAPI specification for StructureDefinition-UserScenario

ValueSet-CDSCv2.A API

OpenAPI specification for ValueSet-CDSCv2.A

StructureDefinition-Persona API

OpenAPI specification for StructureDefinition-Persona

ValueSet-CDHIv1.3 API

OpenAPI specification for ValueSet-CDHIv1.3

ValueSet-CDHIv1.1 API

OpenAPI specification for ValueSet-CDHIv1.1

ValueSet-SGAuthoringSkillsVS API

OpenAPI specification for ValueSet-SGAuthoringSkillsVS

ValueSet-CDSCv2.C API

OpenAPI specification for ValueSet-CDSCv2.C

ValueSet-SGPersonaTypesVS API

OpenAPI specification for ValueSet-SGPersonaTypesVS

StructureDefinition-CoreDataElementSource API

OpenAPI specification for StructureDefinition-CoreDataElementSource

StructureDefinition-ProgramIndicatorSource API

OpenAPI specification for StructureDefinition-ProgramIndicatorSource

ValueSet-DecisionTableActions API

OpenAPI specification for ValueSet-DecisionTableActions

StructureDefinition-TestScenario API

OpenAPI specification for StructureDefinition-TestScenario

ValueSet-CDSCv2.B API

OpenAPI specification for ValueSet-CDSCv2.B

ValueSet-CDHIv2.4 API

OpenAPI specification for ValueSet-CDHIv2.4

StructureDefinition-FunctionalRequirement API

OpenAPI specification for StructureDefinition-FunctionalRequirement

StructureDefinition-FHIRSchemaBase API

OpenAPI specification for StructureDefinition-FHIRSchemaBase

ValueSet-CDHIv1.4 API

OpenAPI specification for ValueSet-CDHIv1.4

ValueSet-CoreDataElementTypeVS API

OpenAPI specification for ValueSet-CoreDataElementTypeVS

StructureDefinition-HealthInterventions API

OpenAPI specification for StructureDefinition-HealthInterventions

StructureDefinition-DecisionSupportLogic API

OpenAPI specification for StructureDefinition-DecisionSupportLogic

StructureDefinition-DublinCore API

OpenAPI specification for StructureDefinition-DublinCore

ValueSet-CDHIv2.2 API

OpenAPI specification for ValueSet-CDHIv2.2

ValueSet-CDHIv2 API

OpenAPI specification for ValueSet-CDHIv2

StructureDefinition-Requirements API

OpenAPI specification for StructureDefinition-Requirements

Using the DAK API

Schema Validation

Each JSON Schema can be used to validate data structures in your applications.

  • Type definitions and constraints
  • Property descriptions and examples
  • Required field specifications
  • Enumeration values with links to definitions

JSON-LD Semantic Integration

The JSON-LD vocabularies provide semantic web integration for ValueSet enumerations.

Integration with FHIR

All schemas are derived from the FHIR definitions in this implementation guide.

API Endpoints

The enumeration endpoints provide machine-readable lists of all available schemas.


This documentation hub is automatically generated from the available schema and API definitions.