This page is part of the FHIR Specification (v0.0.82: DSTU 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.4 Resource Organization - Content

A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.

5.4.1 Scope and Usage

This resource may be used in a shared registry of contact and other information for various organizations or it can be used merely as a support for other resources that need to reference organizations, perhaps as a document, message or as a contained resource. If using a registry approach, it's entirely possible for multiple registries to exist, each dealing with different types or levels of organization.

5.4.2 Boundaries and Relationships

Organization is used for collections of people that have come together to achieve an objective. The Group resource is used to identify a collection of people (or animals, devices, etc.) that are gathered for the purpose of analysis or acting upon, but are not expected to act themselves.

5.4.3 Resource Content

This resource is referenced by CarePlan, Composition, Device, DiagnosticReport, DocumentManifest, DocumentReference, Encounter, Immunization, ImmunizationRecommendation, Location, Medication, MessageHeader, Observation, Order, OrderResponse, Patient and Practitioner

<Organization xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: extension, modifierExtension, language, text, and contained -->
 <identifier><!--  0..* Identifier Identifies this organization  across multiple systems --></identifier>
 <name value="[string]"/><!--  0..1 Name used for the organization -->
 <type><!-- 0..1 CodeableConcept Kind of organization --></type>
 <telecom><!--  0..* Contact A contact detail for the organization --></telecom>
 <address><!--  0..* Address An address for the organization --></address>
 <partOf><!-- 0..1 Resource(Organization) 
     The organization of which this organization forms a part --></partOf>
 <contact>  <!-- 0..* Contact for the organization for a certain purpose -->
  <purpose><!-- 0..1 CodeableConcept The type of contact --></purpose>
  <name><!-- 0..1 HumanName A name associated with the contact --></name>
  <telecom><!-- 0..* Contact Contact details (telephone, email, etc)  for a contact --></telecom>
  <address><!-- 0..1 Address Visiting or postal addresses for the contact --></address>
  <gender><!-- 0..1 CodeableConcept Gender for administrative purposes --></gender>
 </contact>
 <location><!-- 0..* Resource(Location) 
     Location(s) the organization uses to provide services --></location>
 <active value="[boolean]"/><!-- 0..1 Whether the organization's record is still in active use -->
</Organization>

Alternate definitions: Schema/Schematron, Resource Profile

5.4.3.1 Terminology Bindings

Path	Definition	Type	Reference
Organization.type	Used to categorize the organization	Example	http://hl7.org/fhir/vs/organization-type
Organization.contact.purpose	The purpose for which you would contact a contact party	Incomplete	http://hl7.org/fhir/vs/contactentity-type
Organization.contact.gender	The gender of a person used for administrative purposes	Incomplete	http://hl7.org/fhir/vs/administrative-gender

Path

Definition

Type

Reference

Organization.type

Used to categorize the organization

Example

http://hl7.org/fhir/vs/organization-type

Organization.contact.purpose

The purpose for which you would contact a contact party

Incomplete

http://hl7.org/fhir/vs/contactentity-type

Organization.contact.gender

The gender of a person used for administrative purposes

Incomplete

http://hl7.org/fhir/vs/administrative-gender

5.4.3.2 Constraints

Inv-1: The organization SHALL at least have a name or an id, and possibly more than one (xpath: count(f:identifier | f:name) > 0)
Inv-3: On Organization.telecom: The telecom of an organization can never be of use 'home' (xpath on f:Organization/f:telecom: count(f:use[@value='home']) = 0)
Inv-2: On Organization.address: An address of an organization can never be of use 'home' (xpath on f:Organization/f:address: count(f:use[@value='home']) = 0)

5.4.4 Notes:

There are two places for contact information: one on Organization itself and zero or more using the ContactEntity construct. The first one is to be used for the generic, public organization point of contact. The ContactEntity is to be used for reaching a person or party that has been designated by the organization to be contacted for a specific purpose or goal.

5.4.5 Search Parameters

Search parameters for this resource. The standard parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name	Type	Description	Paths
_id	token	The logical resource id associated with the resource (must be supported by all servers)
_language	token	The language of the resource
active	token	Whether the organization's record is active	Organization.active
identifier	token	Any identifier for the organization (not the accreditation issuer's identifier)	Organization.identifier
name	string	A portion of the organization's name	Organization.name
partof	reference	Search all organizations that are part of the given organization	Organization.partOf (Organization)
phonetic	string	A portion of the organization's name using some kind of phonetic matching algorithm
type	token	A code for the type of organization	Organization.type