Skip to main content

Organization

Overview​

The Organization resource represents a formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. This includes healthcare organizations, departments, and other entities involved in patient care.

Resource Schema​

Key fields in the Organization resource:

{
  "resourceType": "Organization",
  "id": "example-organization-123",
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov",
          "display": "Healthcare Provider"
        }
      ]
    }
  ],
  "name": "Netsmart Healthcare Clinic",
  "telecom": [
    {
      "system": "phone",
      "value": "555-123-4567"
    }
  ],
  "address": [
    {
      "line": ["123 Healthcare Drive"],
      "city": "Overland Park",
      "state": "KS",
      "postalCode": "66210",
      "country": "US"
    }
  ]
}

Operations​

The Organization resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

Retrieves a specific Organization resource by ID.

HTTP Method: GET
URL: /Organization/{id}

Examples​

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Organization/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Retrieves Organization resources matching specified criteria.

HTTP Method: GET or POST
URL: /Organization or /Organization/_search

Examples​

Search Organizations
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Organization \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns​

Common Workflows​

  1. Provider Directory - Look up healthcare organizations
  2. Care Team Identification - Identify organizations involved in patient care
  3. Referral Management - Find organizations for patient referrals

Relationships to Other Resources​

The Organization resource relates to:

  • Practitioner - Healthcare providers employed by the organization
  • Location - Physical locations operated by the organization
  • Patient - Patients receiving care from the organization

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​

Profiles supported by this resource (as defined in the CapabilityStatement):