# NDH Group - National Directory of Healthcare Providers & Services (NDH) Implementation Guide v2.0.0-current

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **NDH Group**

## Resource Profile: NDH Group 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Group | *Version*:2.0.0-current | |
| * Standards status: *[Trial-use](http://hl7.org/fhir/R4/versions.html#std-process) | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 4 | *Computable Name*:NdhGroup |

 
The NDH Group represents a group of multi-disciplinary providers organized around a specific healthcare program or service, not an individual patient. For example, a diabetic care team may include an endocrinologist, a diabetes educator, and a nutritionist. 

**Usages:**

* Examples for this Profile: [Behavioral Health Group](Group-aGroup.md)
* CapabilityStatements using this Profile: [NDH Server Capability Statement](CapabilityStatement-ndh-server.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.us.ndh|current/StructureDefinition/ndh-Group)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-ndh-Group.csv), [Excel](StructureDefinition-ndh-Group.xlsx), [Schematron](StructureDefinition-ndh-Group.sch) 

### Notes:

### Search Parameters

#### Search Parameter defined by the NDH IG

None defined.

#### Search Parameter defined by FHIR Search Parameter Registry and used by the NDH IG

Since there is no direct individual url for each Search Parameter defined by FHIR Serach Parameter Registry, we have provided the following links for you to access more information about them.

* [Search Parameter Registry](https://hl7.org/fhir/R4/searchparameter-registry.html)
* [Group Search Parameter from Registry](https://hl7.org/fhir/R4/group.html#search)

| | | |
| :--- | :--- | :--- |
| member | reference | `GET [base]/Group?member=Patient/123` |
| managing-entity | reference | `GET [base]/Group?managing-entity={system}|{value}` |
| type | token | `GET [base]/Group?type=some-type` |
| code | token | `GET [base]/Group?code=some-code` |

#### _include Search Parameter

None defined.

#### _revinclude Search parameter

None defined.

#### Special Search Parameters

None defined.



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "ndh-Group",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "pa"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 4,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/ndh/ImplementationGuide/hl7.fhir.us.ndh"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/ndh/ImplementationGuide/hl7.fhir.us.ndh"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Group",
  "version" : "2.0.0-current",
  "name" : "NdhGroup",
  "title" : "NDH Group",
  "status" : "active",
  "date" : "2026-03-30T14:03:58+00:00",
  "publisher" : "HL7 International / Patient Administration",
  "contact" : [{
    "name" : "HL7 International / Patient Administration",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/pafm"
    },
    {
      "system" : "email",
      "value" : "pafm@lists.hl7.org"
    }]
  }],
  "description" : "The NDH Group represents a group of multi-disciplinary providers organized around a specific healthcare program or service, not an individual patient. For example, a diabetic care team may include an endocrinologist, a diabetes educator, and a nutritionist.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US",
      "display" : "United States of America"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Group",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Group",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Group",
      "path" : "Group"
    },
    {
      "id" : "Group.meta.lastUpdated",
      "path" : "Group.meta.lastUpdated",
      "min" : 1
    },
    {
      "id" : "Group.extension",
      "path" : "Group.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Group.extension:location",
      "path" : "Group.extension",
      "sliceName" : "location",
      "short" : "Network coverage area",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-location-reference"]
      }]
    },
    {
      "id" : "Group.extension:endpoint",
      "path" : "Group.extension",
      "sliceName" : "endpoint",
      "short" : "Endpoint Reference",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference"]
      }]
    },
    {
      "id" : "Group.extension:verification-status",
      "path" : "Group.extension",
      "sliceName" : "verification-status",
      "short" : "Group Verification Status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status"]
      }]
    },
    {
      "id" : "Group.extension:artifact-description",
      "path" : "Group.extension",
      "sliceName" : "artifact-description",
      "short" : "Group Description",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/artifact-description|5.2.0"]
      }]
    },
    {
      "id" : "Group.extension:artifact-effectivePeriod",
      "path" : "Group.extension",
      "sliceName" : "artifact-effectivePeriod",
      "short" : "Group Effective Period",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod|5.2.0"]
      }]
    },
    {
      "id" : "Group.identifier",
      "path" : "Group.identifier",
      "mustSupport" : true
    },
    {
      "id" : "Group.active",
      "path" : "Group.active",
      "min" : 1,
      "fixedBoolean" : true,
      "mustSupport" : true
    },
    {
      "id" : "Group.type",
      "path" : "Group.type",
      "fixedCode" : "practitioner"
    },
    {
      "id" : "Group.actual",
      "path" : "Group.actual",
      "fixedBoolean" : true
    },
    {
      "id" : "Group.code",
      "path" : "Group.code",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/ndh/ValueSet/HealthcareServiceCategoryVS"
      }
    },
    {
      "id" : "Group.name",
      "path" : "Group.name",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Group.managingEntity",
      "path" : "Group.managingEntity",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Group.member",
      "path" : "Group.member",
      "mustSupport" : true
    },
    {
      "id" : "Group.member.entity",
      "path" : "Group.member.entity",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Practitioner",
        "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-PractitionerRole"]
      }]
    },
    {
      "id" : "Group.member.period",
      "path" : "Group.member.period",
      "mustSupport" : true
    },
    {
      "id" : "Group.member.inactive",
      "path" : "Group.member.inactive",
      "mustSupport" : true
    }]
  }
}

```
