---
type: "resource-definitions"
title: "OrganizationAffiliation Definitions"
resource: "OrganizationAffiliation"
---
# OrganizationAffiliation Definitions
## OrganizationAffiliation
Defines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship
**Definition:** Defines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship.
**Cardinality:** 0..*
**Mappings:** rim=Role; w5=administrative.individual
## OrganizationAffiliation.identifier
Business identifiers that are specific to this role
**Definition:** Business identifiers that are specific to this role.
**Requirements:** Often, specific identities are assigned for the agent.
**Cardinality:** 0..*
**Type:** [Identifier](/Identifier)
**Summary:** true
**Mappings:** w5=FiveWs.identifier; rim=.id
## OrganizationAffiliation.active
Whether this organization affiliation record is in active use
**Definition:** Whether this organization affiliation record is in active use.
**Comments:** If this value is false, you may refer to the period to see when the role was in active use. If there is no period specified, no inference can be made about when it was active.
**Requirements:** Need to be able to mark an organization affiliation record as not to be used because it was created in error, or otherwise no longer in active use.
**Meaning if Missing:** This resource is generally assumed to be active if no value is provided for the active element
**Cardinality:** 0..1
**Type:** [boolean](/boolean)
**Summary:** true
**Mappings:** w5=FiveWs.status; rim=.statusCode
## OrganizationAffiliation.period
The period during which the participatingOrganization is affiliated with the primary organization
**Definition:** The period during which the participatingOrganization is affiliated with the primary organization.
**Requirements:** An affiliation may be created ahead of time and only be active for a defined period of time. Once the affiliation is complete, the fact that it existed may still be required.
**Cardinality:** 0..1
**Type:** [Period](/Period)
**Summary:** true
**Mappings:** w5=FiveWs.done[x]; rim=.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime
## OrganizationAffiliation.organization
Organization where the role is available
**Definition:** Organization where the role is available (primary organization/has members).
**Comments:** For example, a Spotless Cleaning Services (participatingOrganization) is a supplier (code) to General Hospital (organization). Similarly, General Hospital (participatingOrganization) is a member (code) of Eastern HIE (organization). If there are two organizations that do not have a directional relationship, there would normally be a third organization that represents the joint partnership, and the two organizations would have a relationship to that joint Organization via two OrganizationAffiliations.
**Cardinality:** 0..1
**Type:** Reference([Organization](/Organization))
**Summary:** true
**Mappings:** rim=.scoper
## OrganizationAffiliation.participatingOrganization
Organization that provides/performs the role (e.g. providing services or is a member of)
**Definition:** The Participating Organization provides/performs the role(s) defined by the code to the Primary Organization (e.g. providing services or is a member of).
**Comments:** See comments for OrganizationAffiliation.organization above.
**Cardinality:** 0..1
**Type:** Reference([Organization](/Organization))
**Summary:** true
**Mappings:** rim=.player
## OrganizationAffiliation.network
The network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
**Definition:** The network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined).
**Comments:** e.g. Commonly used for Health Insurance provider networks.
**Cardinality:** 0..*
**Type:** Reference([Organization](/Organization))
**Summary:** true
## OrganizationAffiliation.code
Definition of the role the participatingOrganization plays
**Definition:** Definition of the role the participatingOrganization plays in the association.
**Cardinality:** 0..*
**Type:** [CodeableConcept](/CodeableConcept)
**Binding:** example:[organization-role](/valueset-organization-role)
**Summary:** true
**Mappings:** rim=.code
## OrganizationAffiliation.specialty
Specific specialty of the participatingOrganization in the context of the role
**Definition:** Specific specialty of the participatingOrganization in the context of the role.
**Cardinality:** 0..*
**Type:** [CodeableConcept](/CodeableConcept)
**Binding:** example:[c80-practice-codes](/valueset-c80-practice-codes)
**Summary:** true
**Mappings:** rim=.player.HealthCareProvider[@classCode = 'PROV'].code
## OrganizationAffiliation.location
The location(s) at which the role occurs
**Definition:** The location(s) at which the role occurs.
**Cardinality:** 0..*
**Type:** Reference([Location](/Location))
**Summary:** true
**Mappings:** w5=FiveWs.where[x]; rim=.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC']
## OrganizationAffiliation.healthcareService
Healthcare services provided through the role
**Definition:** Healthcare services provided through the role.
**Cardinality:** 0..*
**Type:** Reference([HealthcareService](/HealthcareService))
**Mappings:** rim=.player.QualifiedEntity[@classCode = 'QUAL'].code
## OrganizationAffiliation.contact
Official contact details at the participatingOrganization relevant to this Affiliation
**Definition:** The contact details of communication devices available at the participatingOrganization relevant to this Affiliation.
**Requirements:** Sometimes a participating organization provides dedicated contacts to handle enquiries specifically for the role provided to the affiliated organization.
**Cardinality:** 0..*
**Type:** [ExtendedContactDetail](/ExtendedContactDetail)
**Constraints:** org-3 | error | The telecom of an organization can never be of use 'home' | telecom.where(use = 'home').empty(); org-4 | error | The address of an organization can never be of use 'home' | address.where(use = 'home').empty()
**Mappings:** rim=.contactParty
## OrganizationAffiliation.endpoint
Technical endpoints providing access to services operated for this role
**Definition:** Technical endpoints providing access to services operated for this role.
**Cardinality:** 0..*
**Type:** Reference([Endpoint](/Endpoint))
**Mappings:** rim=n/a