OrganizationAffiliation | Medplum

On this page

Defines an affiliation/assotiation/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship.

Elements

Name Required Type Description
identifier Identifier[] Business identifiers that are specific to this role
Details
Business identifiers that are specific to this role.
active boolean Whether this organization affiliation record is in active use
Details
Whether this organization affiliation record is in active use.
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.
period Period The period during which the participatingOrganization is affiliated with the primary organization
Details
The period during which the participatingOrganization is affiliated with the primary organization.
organization Reference< Organization > Organization where the role is available
Details
Organization where the role is available (primary organization/has members).
participatingOrganization Reference< Organization > Organization that provides/performs the role (e.g. providing services or is a member of)
Details
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).
network Reference< Organization >[] Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
Details
Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined).
code CodeableConcept[] Definition of the role the participatingOrganization plays
Details
Definition of the role the participatingOrganization plays in the association.
specialty CodeableConcept[] Specific specialty of the participatingOrganization in the context of the role
Details
Specific specialty of the participatingOrganization in the context of the role.
location Reference< Location >[] The location(s) at which the role occurs
Details
The location(s) at which the role occurs.
healthcareService Reference< HealthcareService >[] Healthcare services provided through the role
Details
Healthcare services provided through the role.
telecom ContactPoint[] Contact details at the participatingOrganization relevant to this Affiliation
Details
Contact details at the participatingOrganization relevant to this Affiliation.
endpoint Reference< Endpoint >[] Technical endpoints providing access to services operated for this role
Details
Technical endpoints providing access to services operated for this role.

Search Parameters

Name Type Description Expression
active token Whether this organization affiliation record is in active use OrganizationAffiliation.active
date date The period during which the participatingOrganization is affiliated with the primary organization OrganizationAffiliation.period
email token A value in an email contact OrganizationAffiliation.telecom.where((system = 'email'))
endpoint reference Technical endpoints providing access to services operated for this role OrganizationAffiliation.endpoint
identifier token An organization affiliation's Identifier OrganizationAffiliation.identifier
location reference The location(s) at which the role occurs OrganizationAffiliation.location
network reference Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined) OrganizationAffiliation.network
participating-organization reference The organization that provides services to the primary organization OrganizationAffiliation.participatingOrganization
phone token A value in a phone contact OrganizationAffiliation.telecom.where((system = 'phone'))
primary-organization reference The organization that receives the services from the participating organization OrganizationAffiliation.organization
role token Definition of the role the participatingOrganization plays OrganizationAffiliation.code
service reference Healthcare services provided through the role OrganizationAffiliation.healthcareService
specialty token Specific specialty of the participatingOrganization in the context of the role OrganizationAffiliation.specialty
telecom token The value in any kind of contact OrganizationAffiliation.telecom

Inherited Elements

Name Required Type Description
id string Logical id of this artifact
Details
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
The only time that a resource does not have an id is when it is being submitted to the server using a create operation.
meta Meta Metadata about the resource
Details
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.
implicitRules uri A set of rules under which this content was created
Details
A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.
language code Language of the resource content
Details
The base language in which the resource is written.
text Narrative Text summary of the resource, for human interpretation
Details
A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human.
contained Resource[] Contained, inline Resources
Details
These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
extension Extension[] Additional content defined by implementations
Details
May be used to represent additional information that is not part of the basic definition of the resource.
modifierExtension Extension[] Extensions that cannot be ignored
Details
May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants.

A relationship between 2 organizations over a period of time, where the entities are separate business entities. The relationship can optionally include details of locations/services from the participating organization.

The OrganizationAffiliation enables defining non-hierarchical relationships between organizations. For example:

The Organization.partOf is used to form a hierarchical relationships within an organization which eventually resolves to a single organization. Each child in the tree is a subdivision of the parent.

The OrganizationAffiliation is used to describe the relationship between two distinct organizations. It does not require a hierarchical relationship. A resource instance is for a singular linkage between 2 organizations (it does not contain all members), to create multiple affiliations, create additional resources for the other relationship between other organizations.

Each instance contains its own period, and optionally links to specific related services/locations that are available. These referenced locations/services should be associated with the participating organization, and are available to the primary organization.

This resource should not be used when the affiliates are part of a single organization.