Skip to content
Last updated

Core Organization Data Model

Overview

The Core Organization domain represents a non‑clinical organization. This domain models an organization at a foundational level, capturing legal identity, names, locations, contact details, identifiers, classifications, and business attributes. It is intended for organizations that are not healthcare providers, such as payers, employers, vendors, partners, or corporate entities.


When to Use This Domain

  • Use the Core Organization domain when:
    • You are modeling a non‑clinical organization.
    • Legal, operational, or business identity attributes are required.
    • The organization participates in workflows outside of direct care delivery.
    • You need a canonical organizational identity shared across systems.
  • Do not use this domain when:
    • Modeling healthcare delivery organizations (use Provider – Health Facility instead).

Relationship to Other Domains

  • Entity: Organization
  • Base Domain: Core Organization
  • Note: This domain provides a canonical organizational identity. Domain extensions may be introduced for specialized organizational contexts in the future.

Data Model

The Core Organization schema is composed of legal, contact, classification, and business attribute groups. All fields are optional unless otherwise noted.

Organization Names

Represents the various legal and alternate names used by the organizational identity.

Embedded ClusterAttributeTypeDescription
legalBusinessNameTextLegal business name
otherOrgNameTextAlternate organization name
tradingNameTextDoing‑business‑as (DBA) name
parentOrgNameTextParent organization name

Contact Information (Grouped)

Organization contact information captured as grouped records.

Embedded ClusterAttributeTypeDescription
AddressAddress-Organization address with validity and geolocation
Phone ListPhone List-One or more phone numbers
Fax ListFax List-Fax numbers
Best Time to ContactdayCode SetDay of the week the contact window applies to
startTimeTimeStart time of the preferred contact window
endTimeTimeEnd time of the preferred contact window
allDayBooleanIndicates availability for the entire day

Standalone Addresses

Detailed attributes for organizational physical locations when not grouped.

Embedded ClusterAttributeTypeDescription
addressNameTextAddress label
addressTypeCode SetAddress type
line1TextAddress line 1
line2TextAddress line 2
cityTextCity
districtTextDistrict
stateTextState
postalCodeTextPostal code
countryTextCountry
latitudeNumberLatitude
longitudeNumberLongitude
validFromDateStart date
validToDateEnd date

Phone, Fax, and Email

Standard communication channel attributes.

Embedded ClusterAttributeTypeDescription
Phone NumbersnumberTextPhone number
typeCode SetPhone type
Fax NumbersnumberTextFax number
typeCode SetFax type
EmailsemailTextEmail address
typeCode SetEmail type
validFromDateStart date
validToDateEnd date

Organizational Identifiers

Identifiers used for alternate tracking and unique system recognition.

Embedded ClusterAttributeTypeDescription
Alternate IdentifiersdescriptionTextIdentifier description
typeCode SetIdentifier type
valueTextIdentifier value
statusTextIdentifier status
issuerTextIssuing authority
issueDateDateIssue date
startDateDateValid from
endDateDateValid to
External Unique IdentifiersissuerTextIssuing authority or system
valueTextIdentifier value
statusTextIdentifier status
startDateDateValid from
endDateDateValid to
Employer Identification NumbervalueTextEIN value
statusBooleanStatus
issuerTextIssuer
issueDateDateIssue date
validFromDateValid from
validToDateValid to

Authorized Officials

Individuals authorized to act on behalf of the organization.

Embedded ClusterAttributeTypeDescription
titleTextTitle
prefixTextName prefix
firstTextFirst name
middleTextMiddle name
lastTextLast name
suffixTextName suffix
credentialTextCredentials
phoneNumberTextContact phone number

Classification & Business Attributes

Industry-specific data and legal standing.

Embedded ClusterAttributeTypeDescription
NAICS ClassificationssectorCode SetIndustry classification hierarchy
SIC ClassificationscodeCode SetSIC industry codes
Organization TypestypeTextOrganization type
subTypeTextOrganization subtype
Legal StatustypeCode SetLegal status type
sourceTextSource of verification
effectiveDateDateEffective date
verificationDateDateVerification date
jurisdictionTextJurisdiction
registrationCountryCode SetCountry of registration

Products & Services

Represents offerings associated with the organization.

Embedded ClusterAttributeTypeDescription
nameTextProduct or service name
codeTextProduct code
typeCode SetProduct type
categoryTextCategory
priceNumberPrice
statusCode SetStatus
descriptionTextDescription
launchDateDateLaunch date
marketTextMarket
lineOfBusinessTextLine of business
Service LinesserviceLineTextPrimary service line
subServiceLineTextSpecific sub-service

Operational Profile & Qualifications

Company metrics and standing.

Embedded ClusterAttributeTypeDescription
Number of EmployeesnumberOfEmployeesNumberEmployee count
Founded DatefoundedDateDateDate founded
Annual RevenueannualRevenueNumberRevenue
yearDateRevenue year
QualificationstypeCode SetQualification type
qualificationTextQualification
statusCode SetStatus
issuerTextIssuer
issueDateDateIssue date
validFromDateValid from
validToDateValid to