Summary
The purpose of this document is to provide an overview of data access via the Renown developer service API’ s. This document will cover access into the Hometown Health Provider Directory data. All the public API’ s are RESTful micro-service pa�erns accessed via GraphQL query h�p POST requests to a web API with a single endpoint of access. Using GraphQL abstrac�on provides a layer with many queries via the one endpoint.
API Access
The Provider Directory API endpoint is located on Renown / Hometown Health web servers with 7 / 24 availability.
URI: h�ps:// apps. hometownhealth. com / Services /_ V3.0 / ProviderDirectory / gql
Access to the GraphQL endpoints is done with a h�p POST request to the endpoint. Applica�ons like Postman ®* or Altair ®* client can be used for tes�ng the queries. The response data returned by the query is a JSON �le. GraphQL informa�on can be found here h�ps:// graphql. org / learn / and by searching the internet for how to query a GraphQL endpoint. * Note: Going directly to the API endpoint will not render results. You must use a GraphQL client to view the public methods and data results.
GraphQL Schema’ s for the Hometown Health Provider Directory
Available queries
• getPlans: o [ PlanGraphType ] model available fields
• planName: String!
• PlanDescription: String!
• planCode: String!
• getSpecialties: o [ SpecialtyGraphType ] model available fields
• specialtyCode: String!
• specialtyName: String!
• getSearchResults o input arguments
• searchText String
• searchTextLoca�on String
• searchLa�tude String
• searchLongitude String
• zipcode String
• plan String
• providerType String