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:

`organization_type`	Description
Healthcare Provider	An organization that provides healthcare services
Hospital Department	A department or ward within a hospital (Generally is not applicable to top level organizations)
Organizational Team	An 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)
Government	A political body, often used when including organization records for government bodies such as a Federal Government, State or Local Government
Insurance Company	A company that provides insurance to its subscribers that may include healthcare related policies
Payer	A company, charity, or governmental organization, which processes claims and/or issues payments to providers on behalf of patients or groups of patients
Educational Institute	An educational institution that provides education or research facilities
Religious Institution	An organization that is identified as a part of a religious institution.
Clinical Research Sponsor	An organization that is identified as a Pharmaceutical/Clinical Research Sponsor
Community Group	An un-incorporated community group
Non-Healthcare Business or Corporation	An organization that is a registered business or corporation but not identified by other types
Other	Other type of organization not already specified
Employer	Unofficial 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.