Search by Organization (Providers)

Overview

Similar to searching for Locations by Organization, we can search for Ribbon Organizations using the /organizations endpoint.

If we want to search for providers within the Honor Health System, we can find the relevant Ribbon Organization UUID by searching with the name parameter:

HTTP

https://api.ribbonhealth.com/v1/custom/organizations?name=Honor Health

Alternatively, if we want to search for any health system around New York City, we can use the address parameter to search more broadly:

HTTP

https://api.ribbonhealth.com/v1/custom/organizations?address=Manhattan, NY

Search for Providers within an Organization

With the relevant Organization UUID, we can search for providers in the Health System using the location_organization_ids parameter.

🚧

Make sure you also include the address parameter in the API request. The API request defaults to New York City, so you may get 0 results if the Organization is located elsewhere.

We can search for providers Honor Health System with the following API Request:

HTTP

https://api.ribbonhealth.com/v1/custom/providers?location_organization_ids=d6f550b4-941c-4c4d-9654-6bee589736e1&address=Phoenix&distance=50