Skip to main content

FHIR Provider Directory API

To access the FHIR-compliant Provider Directory API, you must first request a public access token from our token service at

  https://hsprovtest.healthsparq.com/api/healthsparq-public-login-service/v1/token

Each requested token will expire after 15 minutes. No authentication is required because this is a public token. This is a deviation from the JOT methodology because we do not use a client and secret; it is simply passing a public token request. There is no need to pass the token as an authenticated bearer token. It needs to be passed as a subject token inside the header section of your call.

  curl location: 'https://hsprovtest.healthsparq.com/api/healthsparq-public-login-service/v1/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "city":"",
  "state":"",
  "postalCode":"",
  "country":"",
  "insurerCode":"*INSURERCODE*",
  "brandCode":"*BRANDCODE*",
  "productCode":"*PRODUCTCODE*"
  }'

Make sure to include the required metadata and header information to the endpoint. The insurerCode, brandCode and productCode values will vary depending on which provider directory you would like to query. For each, you will need to request a separate token with the appropriate insurerCode, brandCode and productCode values specified.

The HPN Medicaid FHIR Provider Directory API includes the following Plans. When making calls or passing metadata, use the information below to call the data you're looking for.

Health Plan of Nevada Medicaid:

  • insurerCode = HPNSHL_I
  • brandCode = HPNMED
  • ProductCode = UHCHPNMedicaid

Use the token to make subsequent calls to the FHIR Provider Directory APIs. 

For Health Plan of Nevada Medicaid, for example, pass the following:

  curl location: 'https://hsprovtest.healthsparq.com/api/healthsparq-public-login-service/v1/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{ 
  "city":"",
  "state":"",
  "postalCode":"",
  "country":"",
  "insurerCode":"HPNSHL_I",
  "brandCode":"HPNMED",
  "productCode":"UHCHPNMedicaid"
  }'

Our API conforms to the HL7 DaVinci PDEX Plan Net implementation guide (IG) available at https://hl7.org/fhir/us/davinci-pdex-plan-net/. In accordance with the standard IG, we recommend that developers query our API’s /metadata endpoint to generate a Capability Statement as an initial step.

Technical Swagger documentation for our FHIR Provider Directory API is publicly accessible at https://developers.healthsparq.com/swagger/provider-fhir-service/provider-fhir-service/v2/api-docs