WHO SMART Guidelines - HIV
0.4.4 - ci-build

WHO SMART Guidelines - HIV, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.4.4 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-hiv/tree/main and changes regularly. See the Directory of published versions

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

This page provides access to all available DAK (Data Access Kit) API endpoints and schemas. The DAK API provides structured access to ValueSet enumerations and Logical Model definitions used throughout this implementation guide.

OpenAPI Documentation

Interactive Swagger UI documentation for all generated schemas and external API specifications is available in the OpenAPI documentation hub: View OpenAPI Documentation

Using the DAK API

Schema Validation

Each JSON Schema can be used to validate data structures in your applications. The schemas follow the JSON Schema Draft 2020-12 specification and include:

  • 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. Each vocabulary includes:

  • Enumeration class definitions with schema.org compatibility
  • Individual code instances with canonical IRIs
  • Property definitions with range constraints
  • FHIR metadata integration (system URIs, ValueSet references)

Integration with FHIR

All schemas are derived from the FHIR definitions in this implementation guide. Each schema page includes links to the corresponding FHIR resource definitions for complete context.

API Endpoints

The enumeration endpoints provide machine-readable lists of all available schemas, making it easy to discover and integrate with the available data structures programmatically.

Logical Models

The following logical models define the structure for computable representations of WHO DAK content:

HIV.Configuration

This tab describes data about a facility or region that are used in workflows and decision logic (i.e. WHO recommendations depend upon these data elements), but are not specific to an individual (e.g. a high HIV burden setting)

HIV.I Referral

This tab describes the data that are collected during the referral workflow (HIV.I)

HIV.G Diagnostics

This tab describes the data that are collected during the workflow for diagnostics for HIV (HIV.G)

HIV.B HTS visit

This tab describes the data that are collected during the HIV Testing services visit workflow (HIV.B)

HIV.A Registration

This tab describes the data that are collected during the registration workflow (HIV.A)

HIV.D Care-Treatment

This tab describes the data that may be collected during care and treatment clinical visit for HIV workflow (HIV.D)

HIV.H Follow-up

This tab describes the data that are collected during the follow-up and contacting clients workflow (HIV.H)

HIV.D HIV-TB

This tab describes the data that may be collected during care and treatment clinical visit for HIV/TB care (HIV.D)

HIV.E-F PMTCT

This tab describes the data that are collected relevant to HIV care and treatment of pregnant and postpartum women and their newborns during the delivery and postpartum care and the infant diagnosis and final HIV status workflows (HIV.E and HIV.F)

HIV.C PrEP visit

This tab describes the data that may be collected during the pre-exposure prophylaxis (PrEP) or post-exposure prophylaxis (PEP) workflow (HIV.C)

Logical Model Enumeration Schema

JSON Schema defining the structure of the Logical Model enumeration endpoint response

HIV.Surveillance

This tab describes the data that are collected during case surveillance (these data elements are drawn from other tabs and do not include data element IDs).

HIV.Prevention

This tab describes the data that are collected during HIV prevention activities (not covered in the previous business processes)

API 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:

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