National Directory of Healthcare Providers & Services (NDH) Implementation Guide
2.0.0-current - ci-build United States of America flag

National Directory of Healthcare Providers & Services (NDH) Implementation Guide, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 2.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-us-ndh/ and changes regularly. See the Directory of published versions

Extension: NDH Qualification

Official URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification Version: 2.0.0-current
Standards status: Trial-use Active as of 2026-04-22 Maturity Level: 4 Computable Name: Qualification

An extension to add qualifications for an organization (e.g. accreditation) or practitionerRole (e.g. registered to prescribe controlled substances).

Context of Use

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Qualification
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:identifier S 0..* Extension Identifier
..... extension 0..0 Extension
..... url 1..1 uri "identifier"
..... value[x] 1..1 Identifier Value of extension
.... extension:code S 1..1 Extension Code
..... extension 0..0 Extension
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Specialties, Degrees, Licenses, and Certificates Value Set (extensible)
.... extension:issuer S 0..1 Extension Reference to NdhOrganization
..... extension 0..0 Extension
..... url 1..1 uri "issuer"
..... value[x] 1..1 Reference(NDH Organization Profile) Value of extension
.... extension:status S 1..1 Extension Status
..... extension 0..0 Extension
..... url 1..1 uri "status"
..... value[x] 1..1 code Value of extension
Binding: Qualification Status Value Set (required)
Fixed Value: active
.... extension:period S 0..1 Extension Period
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
.... extension:whereValid S 0..* Extension Where the qualification is valid
..... extension 0..0 Extension
..... url 1..1 uri "whereValid"
..... value[x] 1..1 Value of extension
Binding: UspsTwoLetterAlphabeticCodes (6.1.0) (required)
...... valueCodeableConcept CodeableConcept
...... valueReference Reference(NDH Location Profile)
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:code.​value[x] Base extensible Specialties, Degrees, Licenses, and Certificates Value Set 📦2.0.0-current This IG
Extension.extension:status.​value[x] Base required Qualification Status Value Set 📦2.0.0-current This IG
Extension.extension:whereValid.​value[x] Base required USPS Two Letter Alphabetic Codes 📍6.1.0 US Core v6.1
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Qualification
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:identifier S 0..* Extension Identifier
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "identifier"
..... value[x] 1..1 Identifier Value of extension
.... extension:code S 1..1 Extension Code
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Specialties, Degrees, Licenses, and Certificates Value Set (extensible)
.... extension:issuer S 0..1 Extension Reference to NdhOrganization
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "issuer"
..... value[x] 1..1 Reference(NDH Organization Profile) Value of extension
.... extension:status S 1..1 Extension Status
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "status"
..... value[x] 1..1 code Value of extension
Binding: Qualification Status Value Set (required)
Fixed Value: active
.... extension:period S 0..1 Extension Period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
.... extension:whereValid S 0..* Extension Where the qualification is valid
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "whereValid"
..... value[x] 1..1 Value of extension
Binding: UspsTwoLetterAlphabeticCodes (6.1.0) (required)
...... valueCodeableConcept CodeableConcept
...... valueReference Reference(NDH Location Profile)
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:code.​value[x] Base extensible Specialties, Degrees, Licenses, and Certificates Value Set 📦2.0.0-current This IG
Extension.extension:status.​value[x] Base required Qualification Status Value Set 📦2.0.0-current This IG
Extension.extension:whereValid.​value[x] Base required USPS Two Letter Alphabetic Codes 📍6.1.0 US Core v6.1

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

Summary

Complex Extension: An extension to add qualifications for an organization (e.g. accreditation) or practitionerRole (e.g. registered to prescribe controlled substances).

  • identifier: Identifier: An Extension
  • code: CodeableConcept: An Extension
  • issuer: Reference: An Extension
  • status: code: An Extension
  • period: Period: An Extension
  • whereValid: CodeableConcept, Reference: An Extension

Maturity: 4

Differential ViewDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Qualification
... extension 2..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:identifier S 0..* Extension Identifier
..... extension 0..0 Extension
..... url 1..1 uri "identifier"
..... value[x] 1..1 Identifier Value of extension
.... extension:code S 1..1 Extension Code
..... extension 0..0 Extension
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Specialties, Degrees, Licenses, and Certificates Value Set (extensible)
.... extension:issuer S 0..1 Extension Reference to NdhOrganization
..... extension 0..0 Extension
..... url 1..1 uri "issuer"
..... value[x] 1..1 Reference(NDH Organization Profile) Value of extension
.... extension:status S 1..1 Extension Status
..... extension 0..0 Extension
..... url 1..1 uri "status"
..... value[x] 1..1 code Value of extension
Binding: Qualification Status Value Set (required)
Fixed Value: active
.... extension:period S 0..1 Extension Period
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
.... extension:whereValid S 0..* Extension Where the qualification is valid
..... extension 0..0 Extension
..... url 1..1 uri "whereValid"
..... value[x] 1..1 Value of extension
Binding: UspsTwoLetterAlphabeticCodes (6.1.0) (required)
...... valueCodeableConcept CodeableConcept
...... valueReference Reference(NDH Location Profile)
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:code.​value[x] Base extensible Specialties, Degrees, Licenses, and Certificates Value Set 📦2.0.0-current This IG
Extension.extension:status.​value[x] Base required Qualification Status Value Set 📦2.0.0-current This IG
Extension.extension:whereValid.​value[x] Base required USPS Two Letter Alphabetic Codes 📍6.1.0 US Core v6.1

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NDH Qualification
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:identifier S 0..* Extension Identifier
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "identifier"
..... value[x] 1..1 Identifier Value of extension
.... extension:code S 1..1 Extension Code
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "code"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Specialties, Degrees, Licenses, and Certificates Value Set (extensible)
.... extension:issuer S 0..1 Extension Reference to NdhOrganization
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "issuer"
..... value[x] 1..1 Reference(NDH Organization Profile) Value of extension
.... extension:status S 1..1 Extension Status
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "status"
..... value[x] 1..1 code Value of extension
Binding: Qualification Status Value Set (required)
Fixed Value: active
.... extension:period S 0..1 Extension Period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
.... extension:whereValid S 0..* Extension Where the qualification is valid
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "whereValid"
..... value[x] 1..1 Value of extension
Binding: UspsTwoLetterAlphabeticCodes (6.1.0) (required)
...... valueCodeableConcept CodeableConcept
...... valueReference Reference(NDH Location Profile)
... url 1..1 uri "http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:code.​value[x] Base extensible Specialties, Degrees, Licenses, and Certificates Value Set 📦2.0.0-current This IG
Extension.extension:status.​value[x] Base required Qualification Status Value Set 📦2.0.0-current This IG
Extension.extension:whereValid.​value[x] Base required USPS Two Letter Alphabetic Codes 📍6.1.0 US Core v6.1

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

Summary

Complex Extension: An extension to add qualifications for an organization (e.g. accreditation) or practitionerRole (e.g. registered to prescribe controlled substances).

  • identifier: Identifier: An Extension
  • code: CodeableConcept: An Extension
  • issuer: Reference: An Extension
  • status: code: An Extension
  • period: Period: An Extension
  • whereValid: CodeableConcept, Reference: An Extension

Maturity: 4

 

Other representations of profile: CSV, Excel, Schematron