This profile enables NDH to describe formal affiliations between organizations in a computable way so consumers can understand delegated services, shared networks, service locations, and endpoint relationships that drive referral and access pathways; it adds extensions for verification, and branding, and uses ValueSet bindings for affiliation role and specialty coding to improve consistent role interpretation across implementations.

Background & Scope

OrganizationAffiliation resource is designed to outline connections between multiple organizations. This includes details on the services provided by one organization to another, the location(s) where services are available, the electronic endpoints used, and other relevant information.

OrganizationAffiliation is useful for defining relationships between organizations that do not have a hierarchical structure. For instance:

• One organization may provide services to another organization
• Two or more organizations may collaborate in a partnership or joint venture
• An organization may be a member of another organization, without being owned by it (for example, a hospital can be a member of the American Hospital Association or a health information exchange network).

OrganizationAffiliation and practitionerRole share a similar structure. However, while practitionerRole references both practitioner and organization, OrganizationAffiliation involves references to a participatingOrg and an organization. The participating organization provides "services" to the primary organization, just as a practitioner provides services to an organization. To illustrate this, here are examples for the three cases mentioned earlier:

The participating organization provides services to the primary organization. In a joint venture, the joint venture itself is the primary organization, while partners within the joint venture are considered participating organizations. This requires two instances of the OrganizationAffiliation resource. In an association, the association is the primary organization, and its members are participating organizations. Additionally, OrganizationAffiliation is used to indicate when an organization provides services for a health insurance provider network.

Each instance has its own time period and can optionally include links to specific related services or locations that are accessible. These referenced locations or services should be associated with the participating organization and may available to the primary organization.

An OrganizationAffiliation role could encompass various healthcare services at multiple locations. When different locations provide distinct services, it is recommended to employ multiple OrganizationAffiliation resources and to separate them by location.

To associate an organization to an active network, it could be achieved by modifying the OrganizationAffiliation.period or for the organization. To change a network, it is necessary to create a new OrganizationAffiliation.

An organization has the capability to be affiliated with multiple networks. However, to ensure clarity and avoid confusion, it is recommended that each OrganizationAffiliation corresponds to only one network, even if the affiliations occur at different times.

• Key Elements Table
• Differential Table
• Snapshot Table
• Statistics/References
• All

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
OrganizationAffiliation.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.Slices for extension				Content/Rules for all slices
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
OrganizationAffiliation.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active	Σ This element is included in summaries.	1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported. Σ This element is included in summaries.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network	Σ This element is included in summaries.	0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code	Σ This element is included in summaries.	0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty	Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom	Σ This element is included in summaries.	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​identifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

This structure is derived from OrganizationAffiliation

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.meta
OrganizationAffiliation.meta.lastUpdated		1..1	instant	When the resource version last changed
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.identifier	S This element must be supported.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.Slices for extension				Content/Rules for all slices
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.assigner		0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active		1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network		0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code		0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty		0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom		0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
OrganizationAffiliation.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
OrganizationAffiliation.meta.id		0..1	string	Unique id for inter-element referencing
OrganizationAffiliation.meta.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
OrganizationAffiliation.meta.versionId	Σ This element is included in summaries.	0..1	id	Version specific identifier
OrganizationAffiliation.meta.lastUpdated	Σ This element is included in summaries.	1..1	instant	When the resource version last changed
OrganizationAffiliation.meta.source	Σ This element is included in summaries.	0..1	uri	Identifies where the resource comes from
OrganizationAffiliation.meta.profile	Σ This element is included in summaries.	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
OrganizationAffiliation.meta.security	Σ This element is included in summaries.	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
OrganizationAffiliation.meta.tag	Σ This element is included in summaries.	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
OrganizationAffiliation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
OrganizationAffiliation.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
OrganizationAffiliation.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
OrganizationAffiliation.contained		0..*	Resource	Contained, inline Resources
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
OrganizationAffiliation.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.id		0..1	string	Unique id for inter-element referencing
OrganizationAffiliation.identifier.Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
OrganizationAffiliation.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
OrganizationAffiliation.identifier.system	Σ This element is included in summaries.	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
OrganizationAffiliation.identifier.value	Σ This element is included in summaries.	0..1	string	The value that is unique Example General: 123456
OrganizationAffiliation.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
OrganizationAffiliation.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active	Σ This element is included in summaries.	1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported. Σ This element is included in summaries.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network	Σ This element is included in summaries.	0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code	Σ This element is included in summaries.	0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty	Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom	Σ This element is included in summaries.	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​meta.security	Base	extensible	SecurityLabels	📍4.0.1	FHIR Std.
OrganizationAffiliation.​meta.tag	Base	example	Common Tags	📍4.0.1	FHIR Std.
OrganizationAffiliation.​language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
OrganizationAffiliation.​identifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
OrganizationAffiliation.​identifier.type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
OrganizationAffiliation.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.Slices for extension				Content/Rules for all slices
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
OrganizationAffiliation.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active	Σ This element is included in summaries.	1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported. Σ This element is included in summaries.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network	Σ This element is included in summaries.	0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code	Σ This element is included in summaries.	0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty	Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom	Σ This element is included in summaries.	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​identifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

Differential View

This structure is derived from OrganizationAffiliation

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.meta
OrganizationAffiliation.meta.lastUpdated		1..1	instant	When the resource version last changed
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.identifier	S This element must be supported.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.Slices for extension				Content/Rules for all slices
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.assigner		0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active		1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network		0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code		0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty		0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom		0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

Snapshot ViewView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
OrganizationAffiliation	C	0..*	OrganizationAffiliation	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Constraints: organization-or-participatingOrganization
OrganizationAffiliation.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
OrganizationAffiliation.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
OrganizationAffiliation.meta.id		0..1	string	Unique id for inter-element referencing
OrganizationAffiliation.meta.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
OrganizationAffiliation.meta.versionId	Σ This element is included in summaries.	0..1	id	Version specific identifier
OrganizationAffiliation.meta.lastUpdated	Σ This element is included in summaries.	1..1	instant	When the resource version last changed
OrganizationAffiliation.meta.source	Σ This element is included in summaries.	0..1	uri	Identifies where the resource comes from
OrganizationAffiliation.meta.profile	Σ This element is included in summaries.	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
OrganizationAffiliation.meta.security	Σ This element is included in summaries.	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
OrganizationAffiliation.meta.tag	Σ This element is included in summaries.	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
OrganizationAffiliation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
OrganizationAffiliation.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
OrganizationAffiliation.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
OrganizationAffiliation.contained		0..*	Resource	Contained, inline Resources
OrganizationAffiliation.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
OrganizationAffiliation.Slices for extension.extension:verification-status		0..1	CodeableConcept	NDH Verification Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status Binding: NDH Verification Status Value Set (extensible)
OrganizationAffiliation.Slices for extension.extension:logo		0..1	Attachment	NDH Logo URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
OrganizationAffiliation.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
OrganizationAffiliation.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Business identifiers that are specific to this role
OrganizationAffiliation.identifier.id		0..1	string	Unique id for inter-element referencing
OrganizationAffiliation.identifier.Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
OrganizationAffiliation.identifier.Slices for extension.extension:identifier-status		0..1	code	NDH Identifier Status URL: http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status Binding: Identifier Status Value Set (required)
OrganizationAffiliation.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
OrganizationAffiliation.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
OrganizationAffiliation.identifier.system	Σ This element is included in summaries.	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
OrganizationAffiliation.identifier.value	Σ This element is included in summaries.	0..1	string	The value that is unique Example General: 123456
OrganizationAffiliation.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
OrganizationAffiliation.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that issued id (may be just text)
OrganizationAffiliation.active	Σ This element is included in summaries.	1..1	boolean	Whether this organization affiliation record is in active use Required Pattern: true (extensions allowed)
OrganizationAffiliation.period	S This element must be supported. Σ This element is included in summaries.	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization where the role is available
OrganizationAffiliation.participatingOrganization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(NDH Organization Profile)	Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network	Σ This element is included in summaries.	0..*	Reference(NDH Network Profile)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code	Σ This element is included in summaries.	0..*	CodeableConcept	Definition of the role the participatingOrganization plays Binding: OrganizationAffiliation Roles (extensible)
OrganizationAffiliation.specialty	Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization. Additional Bindings Purpose Documentation HealthcareProviderTaxonomy (20240606) Extensible The specialty(ies) at the organization in this affiliation.
OrganizationAffiliation.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(NDH Location Profile)	The location(s) at which the role occurs
OrganizationAffiliation.healthcareService		0..*	Reference(NDH HealthcareService Profile)	Healthcare services provided through the role
OrganizationAffiliation.telecom	Σ This element is included in summaries.	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint	S This element must be supported.	0..*	Reference(NDH Endpoint Profile)	Technical endpoints providing access to services operated for this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
OrganizationAffiliation.​meta.security	Base	extensible	SecurityLabels	📍4.0.1	FHIR Std.
OrganizationAffiliation.​meta.tag	Base	example	Common Tags	📍4.0.1	FHIR Std.
OrganizationAffiliation.​language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
OrganizationAffiliation.​identifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
OrganizationAffiliation.​identifier.type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
OrganizationAffiliation.​code	Base	extensible	OrganizationAffiliation Roles	📦2.0.0-current	This IG
OrganizationAffiliation.​specialty	Base	preferred	Practice Setting Code Value Set	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
organization-or-participatingOrganization	error	OrganizationAffiliation	NdhOrganizationAffiliation.organization or NdhOrganizationAffiliation.participatingOrganization	organization.exists() or participatingOrganization.exists()

This structure is derived from OrganizationAffiliation

Summary

Mandatory: 1 element(1 nested mandatory element)
Must-Support: 6 elements

Structures

This structure refers to these other structures:

• NDH Organization Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization)
• NDH Network Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Network)
• NDH Location Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Location)
• NDH HealthcareService Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-HealthcareService)
• NDH Endpoint Profile (http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Endpoint)

Extensions

This structure refers to these extensions:

• http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status
• http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-logo
• http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status

Maturity: 4

Search Parameters

_include Search Parameter

_revinclude Search Parameter

None

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 is recommended.

Search Examples

Search OrganizationAffiliation resource based on the role of the participatingOrganization: Get [base]/OrganizationAffiliation?code=HieInitiator

Search OrganizationAffiliation resources which have participatingOrganization present: Get [base]/OrganizationAffiliation?_include=OrganizationAffiliation:participatingOrganization

Search Organization resource which associate with OrganizationAffiliation: Get [base]/Organization?_revinclude=OrganizationAffiliation:participatingOrganization