Assigning patients to organizations

Capable Health has a flexible concept of Organizations. One use for the Organizations resource is to store data about where your Patients are employed. You may want to store this data if you offer your app through employers as part of a corporate benefits package.

An Organization must have a name and can optionally have an organization_type and a logo. Below are the available options for the organization_type value, taken from the corresponding FHIR value set:

Healthcare ProviderAn organization that provides healthcare services
Hospital DepartmentA department or ward within a hospital (Generally is not applicable to top level organizations)
Organizational TeamAn organizational team is usually a grouping of practitioners that perform a specific function within an organization (which could be a top level organization, or a department)
GovernmentA political body, often used when including organization records for government bodies such as a Federal Government, State or Local Government
Insurance CompanyA company that provides insurance to its subscribers that may include healthcare related policies
PayerA company, charity, or governmental organization, which processes claims and/or issues payments to providers on behalf of patients or groups of patients
Educational InstituteAn educational institution that provides education or research facilities
Religious InstitutionAn organization that is identified as a part of a religious institution.
Clinical Research SponsorAn organization that is identified as a Pharmaceutical/Clinical Research Sponsor
Community GroupAn un-incorporated community group
Non-Healthcare Business or CorporationAn organization that is a registered business or corporation but not identified by other types
OtherOther type of organization not already specified
EmployerUnofficial organization_type (not present in the FHIR value set), representing a generic employer

Adding a logo to an Organization

You may want to display an Organization’s logo in your app. You can store an Organization’s logo in Capable Health using the /organizations/{id}/logo endpoint after you create the Organization.

Associating a Patient with one or more Organizations

You can associate a Patient with one or more Organizations using the organization_ids parameter in a PATCH call to the /patients/{id} endpoint, passing the relevant Organization IDs.