SMART ICVP
0.3.0 - ci-build

SMART ICVP, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-icvp/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

DAK API Documentation Hub

This page provides comprehensive documentation for 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.

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 (6 available)

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

Country Schema

JSON Schema for Country ValueSet codes. Generated from FHIR expansions using IRI format.

WHO ICVP Vaccine Product Ids Schema

JSON Schema for WHO ICVP Vaccine Product Ids ValueSet codes. Generated from FHIR expansions using IRI format.

VaccineManufacturer Schema

JSON Schema for VaccineManufacturer ValueSet codes. Generated from FHIR expansions using IRI format.

Vaccine Types for use in the ICVP Schema

JSON Schema for Vaccine Types for use in the ICVP ValueSet codes. Generated from FHIR expansions using IRI format.

Relationship Status for Contact in Patient Schema

JSON Schema for Relationship Status for Contact in Patient ValueSet codes. Generated from FHIR expansions using IRI format.

v2 SEX Schema

JSON Schema for v2 SEX ValueSet codes. Generated from FHIR expansions using IRI format.

Logical Model Schemas (9 available)

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

ICVP - Vaccine Details

Vaccine Data elements for the International Certificate of Vaccination or Prophylaxis

ICVP

Data elements for the Model International Certificate of Vaccination or Prophylaxis.

pICVP - Vaccine Details

Vaccine Data elements for the Paper Model International Certificate of Vaccination or Prophylaxis.

ICVP (single)

ICVP for a single vaccincation event

ICVP HCERT Payload

Mininmial DVC payload for use within an HCERT Payload using the ICVP Product Catalogue

ICVP HCERT Payload

Mininmial vaccine detail in DVC payload for use within an HCERT Payload using the ICVP Product Catalogue

pICVP

Data elements for the Paper Model International Certificate of Vaccination or Prophylaxis.

OpenAPI Documentation

Complete API specification documentation for all available endpoints:

ValueSet-v3-Country Endpoints

API endpoints for Country Schema

ValueSet-ICVPProductIds Endpoints

API endpoints for WHO ICVP Vaccine Product Ids Schema

ValueSet-VaccineManufacturer Endpoints

API endpoints for VaccineManufacturer Schema

ValueSet-ICVPVaccineType Endpoints

API endpoints for Vaccine Types for use in the ICVP Schema

ValueSet-DVCRelationshipStatus Endpoints

API endpoints for Relationship Status for Contact in Patient Schema

ValueSet-v2-0001 Endpoints

API endpoints for v2 SEX Schema

StructureDefinition-ICVPSD Endpoints

API endpoints for DVC Icvp with Selective Disclosure

StructureDefinition-ICVPVaccineDetailsSD Endpoints

API endpoints for ICVP Vaccine Details with Selective Disclosure

StructureDefinition-ICVPVaccineDetails Endpoints

API endpoints for ICVP - Vaccine Details

StructureDefinition-ICVP Endpoints

API endpoints for ICVP

StructureDefinition-pICVPVaccineDetails Endpoints

API endpoints for pICVP - Vaccine Details

StructureDefinition-ICVPEvent Endpoints

API endpoints for ICVP (single)

StructureDefinition-ICVPMin Endpoints

API endpoints for ICVP HCERT Payload

StructureDefinition-ICVPMinVaccineDetails Endpoints

API endpoints for ICVP HCERT Payload

StructureDefinition-pICVP Endpoints

API endpoints for pICVP

ValueSets Enumeration Endpoint

Complete list of all available ValueSet schemas

LogicalModels Enumeration Endpoint

Complete list of all available Logical Model schemas

StructureDefinition-ICVPEvent API

OpenAPI specification for StructureDefinition-ICVPEvent

StructureDefinition-ICVPMin API

OpenAPI specification for StructureDefinition-ICVPMin

StructureDefinition-ICVPVaccineDetails API

OpenAPI specification for StructureDefinition-ICVPVaccineDetails

ValueSet-VaccineManufacturer API

OpenAPI specification for ValueSet-VaccineManufacturer

StructureDefinition-ICVPVaccineDetailsSD API

OpenAPI specification for StructureDefinition-ICVPVaccineDetailsSD

ValueSet-v3-Country API

OpenAPI specification for ValueSet-v3-Country

LogicalModels-enumeration API

OpenAPI specification for LogicalModels-enumeration

StructureDefinition-ICVPMinVaccineDetails API

OpenAPI specification for StructureDefinition-ICVPMinVaccineDetails

ValueSets-enumeration API

OpenAPI specification for ValueSets-enumeration

StructureDefinition-ICVPSD API

OpenAPI specification for StructureDefinition-ICVPSD

StructureDefinition-pICVPVaccineDetails API

OpenAPI specification for StructureDefinition-pICVPVaccineDetails

StructureDefinition-pICVP API

OpenAPI specification for StructureDefinition-pICVP

ValueSet-ICVPVaccineType API

OpenAPI specification for ValueSet-ICVPVaccineType

ValueSet-DVCRelationshipStatus API

OpenAPI specification for ValueSet-DVCRelationshipStatus

ValueSet-v2-0001 API

OpenAPI specification for ValueSet-v2-0001

ValueSet-ICVPProductIds API

OpenAPI specification for ValueSet-ICVPProductIds

StructureDefinition-ICVP API

OpenAPI specification for StructureDefinition-ICVP

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.


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