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

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

## Resource Profile: NDH Organization Profile 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization | *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*:NdhOrganization |

 
An organization is a formal or informal grouping of people or organizations with a common purpose, such as a company, institution, corporation, community group, or healthcare practice. Guidance: When the contact is a department name, rather than a human (e.g., patient help line), include a blank family and given name, and provide the department name in contact.name.text 

### Boundraries and Relationships

The Organization resource is commonly structured as a hierarchy of organization resources, where the part-of property is used to indicate the relationship between child and parent organizations. This hierarchy serves to convey the conceptual structure of the organization. Organization has following key attributes:

1. A unique logical identifier that identifies the organization as an entity.
1. The name of the organization as known to humans.
1. Telecommunication identifiers that can be used to reach the organization.
1. Information about any large organizations that the organization might be part of.
1. One or more endpoints for electronic communication and data exchange.

Note: The NDH Organization and Network profiles are both based on the Organization profile. To selectively query only Network profiles, search for type = 'ntwk'. To selectively query only Organization profiles, the type parameter is optional. However, you can provide any value defined in the [Organization Type Value Set](ValueSet-OrgTypeVS.md).

**Usages:**

* Refer to this Profile: [NDH Endpoint Testing Certification](StructureDefinition-base-ext-endpoint-testing-certification.md), [NDH Funding Source](StructureDefinition-base-ext-fundingSource.md), [NDH Qualification](StructureDefinition-base-ext-qualification.md), [NDH Via Intermediary](StructureDefinition-base-ext-via-intermediary.md)... Show 11 more, [NDH Endpoint Profile](StructureDefinition-ndh-Endpoint.md), [NDH Group](StructureDefinition-ndh-Group.md), [NDH HealthcareService Profile](StructureDefinition-ndh-HealthcareService.md), [NDH InsurancePlan Profile](StructureDefinition-ndh-InsurancePlan.md), [NDH Location Profile](StructureDefinition-ndh-Location.md), [NDH Network Profile](StructureDefinition-ndh-Network.md), [NDH Organization Profile](StructureDefinition-ndh-Organization.md), [NDH OrganizationAffiliation Profile](StructureDefinition-ndh-OrganizationAffiliation.md), [NDH Practitioner Profile](StructureDefinition-ndh-Practitioner.md), [NDH PractitionerRole](StructureDefinition-ndh-PractitionerRole.md) and [NDH Verification](StructureDefinition-ndh-Verification.md)
* Examples for this Profile: [Acme of CT](Organization-Acme.md), [Big Box Retailer](Organization-BigBox.md), [BlueCrossBlueShield CT Organization](Organization-BlueCrossBlueShield-CT-ORG.md), [Burr Clinic](Organization-BurrClinic.md)... Show 14 more, [Hamilton Clinic](Organization-HamiltonClinic.md), [Hartford Orthopedics Services](Organization-HartfordOrthopedics.md), [Hartford General Hospital](Organization-Hospital.md), [Housing Assistance Hub Management](Organization-OrgHousingAssistanceHubManagement.md), [Organization Manage Payer Network (OMPN)](Organization-OrgManageNetwork.md), [OrgOneWithNetwork1AndNetwork2](Organization-OrgOneWithNetwork1AndNetwork2.md), [Hope INC](Organization-Organization-Social-Hope-CBO.md), [Hope INC](Organization-Organization-Social-Towson-Food.md), [OrganizationGen1](Organization-OrganizationGen1.md), [OrganizationGen2](Organization-OrganizationGen2.md), [StateMedicaidAgencyAlabama](Organization-OrganizationStateMedicaidAgencyAlabama.md), [Welcome Home](Organization-OrganizationWelcomeHome.md), [Pharm Chain](Organization-PharmChain.md) and [State of Illinois Licensing Board](Organization-StateOfIllinoisLicBoard.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-Organization)

### 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-Organization.csv), [Excel](StructureDefinition-ndh-Organization.xlsx), [Schematron](StructureDefinition-ndh-Organization.sch) 

### Notes:

### Search Parameters

#### Search Parameter defined by the NDH IG

| | | |
| :--- | :--- | :--- |
| [verification-status](SearchParameter-verification-status.md) | token | `GET [base]/Organization?verification-status=complete` |

#### 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)
* [Organization Search Parameter from Registry](https://hl7.org/fhir/R4/organization.html#search)

| | | |
| :--- | :--- | :--- |
| active | token | `GET [base]/Organization?active=true` |
| address | string | `GET [base]/Organization?address=123 Ravissant Dr` |
| address-city | string | `GET [base]/Organization?address-city=Coconut Creek` |
| address-country | string | `GET [base]/Organization?address-country=USA` |
| address-postalcode | string | `GET [base]/Organization?address-postcode=12345` |
| address-state | string | `GET [base]/Organization?address-state=FL` |
| address-use | token | `GET [base]/Organization?address-use=work` |
| endpoint | reference | `GET [base]/Organization?endpoint.connection-type=hl7-fhir-rest` |
| identifier | token | `GET [base]/Organization?identifier=12345` |
| name | string | `GET [base]/Organization?name=Florida Blue` |
| partof | reference | `GET [base]/Organization?partof.name=Florida Blue` |

#### _include Search Parameter

| | |
| :--- | :--- |
| Organization:endpoint | `GET [base]/Organization?_include=Organization:endpoint` |
| Organization:partof | `GET [base]/Organization?_include=Organization:partof` |

#### _revinclude Search Parameter

| | |
| :--- | :--- |
| Endpoint:organization |   |
| HealthcareService:organization | HealthcareService.providedBy |
| InsurancePlan:administered-by |   |
| InsurancePlan:owned-by |   |
| Location:organization |   |
| OrganizationAffiliation:participating-organization |   |
| OrganizationAffiliation:primary-organization |   |
| Practitioner:qualification-issuer |   |
| PractitionerRole:organization |   |

#### Special Search Parameters

The search parameters outlined above are straightforward for basic scenarios but have limitations in handling complex combination queries. To enhance these capabilities, employing the special search parameters [_filter](https://hl7.org/fhir/R5/search_filter.html#3.2.3) is recommended.



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "ndh-Organization",
  "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-Organization",
  "version" : "2.0.0-current",
  "name" : "NdhOrganization",
  "title" : "NDH Organization Profile",
  "status" : "active",
  "date" : "2026-03-23T21:58:05+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" : "An organization is a formal or informal grouping of people or organizations with a common purpose, such as a company, institution, corporation, \ncommunity group, or healthcare practice. Guidance: When the contact is a department name, rather than a human (e.g., patient help line), include a blank family \nand given name, and provide the department name in contact.name.text",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US",
      "display" : "United States of America"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "ndh-to-plannet-organization",
    "uri" : "http://hl7.org/fhir/us/davinci-pdex-plan-net",
    "name" : "NDH to Plan-Net Organization Mapping",
    "comment" : "Maps NDH Organization profile to the Plan-Net Organization profile, noting elements not present\nin Plan-Net."
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "servd",
    "uri" : "http://www.omg.org/spec/ServD/1.0/",
    "name" : "ServD"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Organization",
  "baseDefinition" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization|6.1.0",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Organization",
      "path" : "Organization",
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization",
        "comment" : "Top-level mapping from NDH to Plan-Net"
      },
      {
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization.extension[org-period]",
        "comment" : "Not in NDH, only in Plan-Net"
      }]
    },
    {
      "id" : "Organization.meta.lastUpdated",
      "path" : "Organization.meta.lastUpdated",
      "min" : 1,
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization.meta.lastUpdated",
        "comment" : ", is required in NDH"
      }]
    },
    {
      "id" : "Organization.extension",
      "path" : "Organization.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Organization.extension:rating",
      "path" : "Organization.extension",
      "sliceName" : "rating",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.extension:paymentaccepted",
      "path" : "Organization.extension",
      "sliceName" : "paymentaccepted",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-paymentAccepted"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.extension:fundingSource",
      "path" : "Organization.extension",
      "sliceName" : "fundingSource",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-fundingSource"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.extension:org-description",
      "path" : "Organization.extension",
      "sliceName" : "org-description",
      "short" : "Organization Description",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-org-description"]
      }]
    },
    {
      "id" : "Organization.extension:qualification",
      "path" : "Organization.extension",
      "sliceName" : "qualification",
      "short" : "Qualification",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-qualification"]
      }]
    },
    {
      "id" : "Organization.extension:insuranceplan",
      "path" : "Organization.extension",
      "sliceName" : "insuranceplan",
      "short" : "Insurance plan(s) offered to the organization's employees",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-insuranceplan-reference"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.extension:cms-enrollment-in-good-standing",
      "path" : "Organization.extension",
      "sliceName" : "cms-enrollment-in-good-standing",
      "short" : "CMS Enrollment In Good Standing",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-cms-enrollment-in-good-standing"]
      }]
    },
    {
      "id" : "Organization.extension:ial2-verified",
      "path" : "Organization.extension",
      "sliceName" : "ial2-verified",
      "short" : "IAL2 Verified",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-cms-ial2-verified"]
      }]
    },
    {
      "id" : "Organization.extension:aligned-with-cms-data-network",
      "path" : "Organization.extension",
      "sliceName" : "aligned-with-cms-data-network",
      "short" : "Aligned with CMS Data Network",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-aligned-with-cms-data-network"]
      }]
    },
    {
      "id" : "Organization.extension:verification-status",
      "path" : "Organization.extension",
      "sliceName" : "verification-status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.extension:logo",
      "path" : "Organization.extension",
      "sliceName" : "logo",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.identifier",
      "path" : "Organization.identifier",
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization.identifier"
      }]
    },
    {
      "id" : "Organization.identifier.extension:identifier-status",
      "path" : "Organization.identifier.extension",
      "sliceName" : "identifier-status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.identifier.assigner",
      "path" : "Organization.identifier.assigner",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }]
    },
    {
      "id" : "Organization.identifier:TID",
      "path" : "Organization.identifier",
      "sliceName" : "TID",
      "short" : "Tax Identifier",
      "min" : 0,
      "max" : "1",
      "patternIdentifier" : {
        "system" : "http://hl7.org/fhir/sid/us-ssn"
      }
    },
    {
      "id" : "Organization.active",
      "path" : "Organization.active",
      "patternBoolean" : true
    },
    {
      "id" : "Organization.type",
      "path" : "Organization.type",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/ndh/ValueSet/OrgTypeVS"
      }
    },
    {
      "id" : "Organization.alias",
      "path" : "Organization.alias",
      "mustSupport" : true,
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization.alias"
      }]
    },
    {
      "id" : "Organization.alias.extension",
      "path" : "Organization.alias.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Organization.alias.extension:org-alias-type",
      "path" : "Organization.alias.extension",
      "sliceName" : "org-alias-type",
      "short" : "Organization Alias Type",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-org-alias-type"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.alias.extension:org-alias-period",
      "path" : "Organization.alias.extension",
      "sliceName" : "org-alias-period",
      "short" : "Organization Alias Period",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-org-alias-period"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.telecom",
      "path" : "Organization.telecom",
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Organization.telecom"
      }]
    },
    {
      "id" : "Organization.telecom.extension:contactpoint-availabletime",
      "path" : "Organization.telecom.extension",
      "sliceName" : "contactpoint-availabletime",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime"]
      }]
    },
    {
      "id" : "Organization.telecom.extension:via-intermediary",
      "path" : "Organization.telecom.extension",
      "sliceName" : "via-intermediary",
      "short" : "Via Intermediary",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary"]
      }]
    },
    {
      "id" : "Organization.telecom.extension:language-speak",
      "path" : "Organization.telecom.extension",
      "sliceName" : "language-speak",
      "short" : "Language Speak",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-language-speak"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-organization",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Organization.address.extension:geolocation",
      "path" : "Organization.address.extension",
      "sliceName" : "geolocation",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/geolocation|4.0.1"]
      }]
    },
    {
      "id" : "Organization.address.state",
      "path" : "Organization.address.state",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state|6.1.0"
      }
    },
    {
      "id" : "Organization.partOf",
      "path" : "Organization.partOf",
      "type" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy",
          "valueBoolean" : true
        }],
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }]
    },
    {
      "id" : "Organization.contact.telecom.extension:contactpoint-availabletime",
      "path" : "Organization.contact.telecom.extension",
      "sliceName" : "contactpoint-availabletime",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime"]
      }]
    },
    {
      "id" : "Organization.contact.telecom.extension:via-intermediary",
      "path" : "Organization.contact.telecom.extension",
      "sliceName" : "via-intermediary",
      "short" : "Via Intermediary",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary"]
      }]
    },
    {
      "id" : "Organization.endpoint",
      "path" : "Organization.endpoint",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Endpoint"]
      }],
      "mustSupport" : true
    }]
  }
}

```
