Organization

The FHIR R4 Organization resource defines entities responsible for providing, managing, or paying for healthcare services. This includes hospitals, clinics, health systems, payers, and other administrative or operational entities. In Health Gorilla, Organization is often referenced by PractitionerRole, Location, and Encounter resources.

Use Cases

  • Identify the facility or organization associated with a provider
  • Filter encounters or locations by managing organization
  • Display organization contact and address information

Base URLs

Authentication

All requests require OAuth 2.0 authentication using a Bearer Token. Unauthorized requests return 401 Unauthorized responses.

Required Scopes

  • organization.read for GET
  • organization.write for POST, PUT, DELETE

For more information, go to: OAuth 2.0 Authentication.

Supported Methods

MethodOperationDescription
GETRead OrganizationRetrieves a specific Organization record by its FHIR ID.
GETSearch OrganizationSearches for Organization records using supported parameters.
POSTCreate OrganizationSubmits a new Organization record to the Health Gorilla FHIR server.
PUTUpdate OrganizationUpdates an existing Organization record by full resource replacement.
DELETEDelete OrganizationRemoves an existing Organization record from the system by full deletion.

Frequently Used Search Parameters

ParameterDescriptionFHIR Value Set / Example ValuesFHIR Data TypeRequired
nameFilters by the organization’s name"Health Gorilla"stringNo
identifierFilters by organization identifierNPI, TIN, or system-specific IDtokenNo
typeFilters by organization typeOrganizationType (prov, pay)tokenNo
_idFilters by the Organization resource IDOrganization/{id}tokenNo
addressMatches any part of the address (city, zip, etc)"Sunnyvale"stringNo

Commonly Returned Resource Attributes

AttributeDescriptionExample ValuesFHIR Data TypeRequired
idUnique FHIR ID for the organizationorg-123456idYes
nameName of the organizationHealth GorillastringYes
identifierUnique business identifiers (NPI, TIN, etc.)NPI: 1234567890Identifier[]No
typeType of organizationprov (healthcare provider)CodeableConcept[]No
activeWhether the organization record is currently activetrue, falsebooleanNo
telecomContact information (e.g., phone, fax, email)408-555-1234ContactPoint[]No
addressPhysical or mailing address123 Wellness Way, Sunnyvale, CAAddress[]No
partOfParent organization, if this is a branch or subdivisionOrganization/{id}Reference(Organization)No
endpointReference to technical endpoints for services like DirectEndpoint/{id}Reference(Endpoint)No

Webhooks

Organization resources are not typically included in webhook notifications directly, but they are commonly referenced by webhook-triggering resources such as Encounter, PractitionerRole, and Location.

For more information, go to: Webhooks & Polling.

Error Handling

All Organization operations follow standard Health Gorilla error handling, including use of FHIR OperationOutcome for structured responses.
For more information, go to: Error Handling.

Additional Resources

HL7 FHIR Organization