Search for Organizations
Endpoint for finding information about healthcare organizations
Overview
Description: The organizations endpoint allows you to search for different organizations.
Endpoint: /v1/custom/organizations
Status: Live -- Please Contact Us to Learn More
Example use-case: Display a map of all of all nearby health systems and their relevant information so that a patient can find care.
Organization Types
This endpoint currently contains information on Health Systems only.
We are planning to release additional organization types (e.g., provider groups) in the future that will be included in this endpoint.
Please feel free to reach out to a Ribbon team member to learn more about our roadmap for this product!
Diving In
This endpoint allows the user to retrieve a list of organizations based on a geospatial or text search.
Example Request
Below is an example of a call to return all health systems with the name "Baptist" in Jacksonville.
curl -X GET \
'https://api.ribbonhealth.com/v1/custom/organizations?name=Baptist&address=Jacksonville&distance=20 \
-H 'authorization: Token your_token'
Example JSON Output
The response normalizes and geocodes the inputted address and also displays the search results:
{
"parameters": {
"page": 1,
"page_size": 25,
"total_count": 1,
"sort_by": "distance",
"distance": 20.0,
"geo": {
"latitude": 30.3321838,
"longitude": -81.65565099999999
},
"address": "Jacksonville, FL, USA",
"name": "baptist"
},
"data": [
{
"uuid": "a1dbf998-a65b-4780-8361-648357785d96",
"name": "Baptist Health (Jacksonville)",
"organization_types": [
"Health System"
],
"websites": [
{
"url": "https://www.baptistjax.com/"
}
],
"ids": [
{
"id": "5",
"id_type": "AHA_ID"
}
],
"address": "841 Prudential Dr # 1601, Jacksonville, FL 32207, US",
"address_details": {
"zip": "32207",
"city": "Jacksonville",
"state": "FL",
"street": "841 Prudential Dr # 1601",
"address_line_1": "841 Prudential Dr",
"address_line_2": "# 1601"
},
"latitude": 30.3159499,
"longitude": -81.6630919,
"phone_numbers": [
{
"phone": "9042022000",
"detail": "primary"
}
]
}
]
}
Parameters
The parameters that the /v1/custom/organizations
endpoint can receive are listed below.
Parameter | Example Value | Required/Optional | Detail |
---|---|---|---|
address | Boston, MA | Optional Required to use address or location parameters in order to leverage distance parameter | Our API geocodes this into longitude/latitude coordinates to use for distance calculations |
name | Baptist Health | Optional | Leverage the "name" search parameter for a 'fuzzy' search on organization name. |
distance | 15 | Optional | Constrains the search to within Y miles of the center point (in this case, without specifying the radius, the API defaults to 10 miles) |
location | 37.7489816,-122.4802092 | Optional, Required to use address or location parameters in order to leverage distance parameter | Comma separated list latitude, longitude coordinates |
Updated 8 months ago