WHO Digital Documentation of COVID-19 Certificates (DDCC)
1.0.0 - CI Build International flag

WHO Digital Documentation of COVID-19 Certificates (DDCC), published by WHO. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/ddcc/tree/main and changes regularly. See the Directory of published versions

Logical Model: DDCC Core Data Set Logical Model for Test Result ( Abstract )

Official URL: http://smart.who.int/ddcc/StructureDefinition/DDCCCoreDataSetTR Version: 1.0.0
Draft as of 2026-01-19 Computable Name: DDCCCoreDataSetTR

Data elements for the DDCC Core Data Set for Test Result.

Usages:

  • This Logical Model is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... name Σ 1..1 string Name
... birthDate Σ 0..1 date Date of birth
... identifier Σ 0..1 Identifier Unique identifier
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... issuer Σ 1..1 Reference(DDCC Organization) Certificate issuer
.... kid 0..1 string Key ID used to verify the signature of the certificate
.... hcid Σ 1..1 Identifier Health certificate identifier (HCID)
.... ddccid Σ 0..1 Identifier DDCC Identifier
.... version Σ 1..1 string Certificate schema version
.... period C 0..1 Period Certificate Validity Period
Constraints: per-1
..... @id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... start ΣC 0..1 dateTime Certificate valid from
..... end ΣC 0..1 dateTime Certificate valid until
... test Σ 1..1 BackboneElement Test Event
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
per-1 error DDCCCoreDataSet.certificate.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)

This structure is derived from DDCCCoreDataSet

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... test Σ 1..1 BackboneElement Test Event
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... name Σ 1..1 string Name
... birthDate Σ 0..1 date Date of birth
... identifier Σ 0..1 Identifier Unique identifier
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... issuer Σ 1..1 Reference(DDCC Organization) Certificate issuer
.... kid 0..1 string Key ID used to verify the signature of the certificate
.... hcid Σ 1..1 Identifier Health certificate identifier (HCID)
.... ddccid Σ 0..1 Identifier DDCC Identifier
.... version Σ 1..1 string Certificate schema version
.... period C 0..1 Period Certificate Validity Period
Constraints: per-1
..... @id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... start ΣC 0..1 dateTime Certificate valid from
..... end ΣC 0..1 dateTime Certificate valid until
... test Σ 1..1 BackboneElement Test Event
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
per-1 error DDCCCoreDataSet.certificate.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)

This structure is derived from DDCCCoreDataSet

Summary

Mandatory: 0 element(5 nested mandatory elements)

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... name Σ 1..1 string Name
... birthDate Σ 0..1 date Date of birth
... identifier Σ 0..1 Identifier Unique identifier
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... issuer Σ 1..1 Reference(DDCC Organization) Certificate issuer
.... kid 0..1 string Key ID used to verify the signature of the certificate
.... hcid Σ 1..1 Identifier Health certificate identifier (HCID)
.... ddccid Σ 0..1 Identifier DDCC Identifier
.... version Σ 1..1 string Certificate schema version
.... period C 0..1 Period Certificate Validity Period
Constraints: per-1
..... @id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... start ΣC 0..1 dateTime Certificate valid from
..... end ΣC 0..1 dateTime Certificate valid until
... test Σ 1..1 BackboneElement Test Event
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
per-1 error DDCCCoreDataSet.certificate.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)

Differential View

This structure is derived from DDCCCoreDataSet

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... test Σ 1..1 BackboneElement Test Event
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. DDCCCoreDataSet 0..* DDCCCoreDataSet This is an abstract type.
DDCC Core Data Set Logical Model for Test Result

Elements defined in Ancestors:name, birthDate, identifier, certificate
... name Σ 1..1 string Name
... birthDate Σ 0..1 date Date of birth
... identifier Σ 0..1 Identifier Unique identifier
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... issuer Σ 1..1 Reference(DDCC Organization) Certificate issuer
.... kid 0..1 string Key ID used to verify the signature of the certificate
.... hcid Σ 1..1 Identifier Health certificate identifier (HCID)
.... ddccid Σ 0..1 Identifier DDCC Identifier
.... version Σ 1..1 string Certificate schema version
.... period C 0..1 Period Certificate Validity Period
Constraints: per-1
..... @id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... start ΣC 0..1 dateTime Certificate valid from
..... end ΣC 0..1 dateTime Certificate valid until
... test Σ 1..1 BackboneElement Test Event
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... pathogen Σ 1..1 Coding Pathogen targeted
Binding: WHO Agent Targeted (COVID-19) (preferred)
.... type Σ 1..1 Coding Type of test
Binding: WHO Type of Covid-19 Test (preferred)
.... brand Σ 0..1 Coding Test brand
.... manufacturer Σ 0..1 Coding Test manufacturer
.... origin Σ 0..1 Coding Specimen Sample Origin
Binding: WHO Speciman Sample Origin (COVID-19) (preferred)
.... date Σ 1..1 dateTime Date and time of sample collection
.... result 0..1 Coding Test result
Binding: WHO Test Result (COVID-19) (preferred)
.... centre 0..1 Coding Test centre or facility name
.... country Σ 1..1 Coding Test centre country
Binding: Iso3166-1-3 (preferred)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
DDCCCoreDataSet.test.​pathogen Base preferred WHO Agent Targeted (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​type Base preferred WHO Type of Covid-19 Test 📦1.0.0 This IG
DDCCCoreDataSet.test.​origin Base preferred WHO Speciman Sample Origin (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​result Base preferred WHO Test Result (COVID-19) 📦1.0.0 This IG
DDCCCoreDataSet.test.​country Base preferred Iso 3166 Part 1: 3 Letter Codes 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
per-1 error DDCCCoreDataSet.certificate.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)

This structure is derived from DDCCCoreDataSet

Summary

Mandatory: 0 element(5 nested mandatory elements)

 

Other representations of profile: CSV, Excel