The HealthCorum Price Transparency API allows our partners to access HealthCorum price transparency data for:

  1. Rates – NPI, CPT and Geo specific pricing
  2. Distributions – Fair market values
  3. Networks – Retrieve network IDs
  4. Procedures – Type-ahead feature for CPT lookup

Using HealthCorum Price Transparency API

The HealthCorum Price Transparency API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs. Our partners use the API by sending requests with a specific structure to our servers.

Our API infrastructure is completely supported by our company security and privacy policies, which are compliant with SOC2 and HIPAA standards.

Getting Authenticated

The HealthCorum Price Transparency API uses API keys to authenticate requests and authentication to the API is performed via HTTP Basic Auth. The partners send HTTPS requests with the Authorization header that contains the word “Basic” followed by a space and a base64-encoded string username:password. 401 “Unauthorized” response is returned for requests with missing or incorrect credentials. This response includes the WWW-Authenticate header.

Request Structure

The API is accessed through GET requests.

 API End Point

https://healthcorumnow.com/api/

API List:

Rates Endpoint

Endpoint: /v3/rates
Methods: GET

 

ParameterData TypeRequired/OptionalDescription
network_idsstring arrayrequiredHealthCorum generated ID
regionstring arrayoptionalTwo letter state abbreveation
npistring arrayoptionalThe National Provider Identifier (NPI), up to 20 within a single call can be passed in a comma separated format
einstring arrayoptionalEmployer Identification Number
radiusdecimaloptional
latitudedecimaloptional
longitudedecimaloptional
place_of_servicestringoptionalHealth plan specific code
taxonomystringoptionalunique 10-character code
billing_classstringoptionalprofessional, institutional
codesstring arrayrequiredArray of CPT codes
sortstringoptional
sort_directionenum(asc, dsc)optionalDefault is asc
limitintegeroptionalDefault is 1000
show_distributionbooleanoptionalDefault is true

 

Distributions Endpoint

Endpoint: /v3/distributions
Methods: GET

 

ParameterData TypeRequired/OptionalDescription
network_idsstring arrayrequiredHealthCorum generated ID
regionstring arrayoptionalTwo letter state abbreveation
radiusdecimaloptional
latitudedecimaloptional
longitudedecimaloptional
place_of_servicestringoptionalHealth plan specific code
taxonomystringoptionalunique 10-character code
billing_classstringoptionalprofessional, institutional
codestringrequiredCPT code
limitintegeroptionalDefault is 1000

 

Networks Endpoint

Endpoint: /v3/networks
Methods: GET

ParameterData TypeRequired/OptionalDescription
regionstringoptionalTwo letter state abbreviation

 

Procedures Endpoint

Endpoint: /v3/procedures
Methods: GET

Search provider experience based on procedure code and location 

ParameterData TypeRequired/OptionalDescription
qstringrequiredpartial procedure text
limitintegeroptional1000 as default