HealthCorum logo
REQUEST A DEMO
☰
Solutions ▼
Executive Dashboards Transparency Hub
Who We Are
Company ▼
Events Teams
Resources ▼
Articles Resource Center Webinars Media Thought Leadership
Login REQUEST A DEMO

Price Transparency API’s

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

Parameter Data Type Required/Optional Description
network_ids string array required HealthCorum generated ID
region string array optional Two letter state abbreveation
npi string array optional The National Provider Identifier (NPI), up to 20 within a single call can be passed in a comma separated format
ein string array optional Employer Identification Number
radius decimal optional
latitude decimal optional
longitude decimal optional
place_of_service string optional Health plan specific code
taxonomy string optional unique 10-character code
billing_class string optional professional, institutional
codes string array required Array of CPT codes
sort string optional
sort_direction enum(asc, dsc) optional Default is asc
limit integer optional Default is 1000
show_distribution boolean optional Default is true

Distributions Endpoint

Endpoint: /v3/distributions
Methods: GET

Parameter Data Type Required/Optional Description
network_ids string array required HealthCorum generated ID
region string array optional Two letter state abbreveation
radius decimal optional
latitude decimal optional
longitude decimal optional
place_of_service string optional Health plan specific code
taxonomy string optional unique 10-character code
billing_class string optional professional, institutional
code string required CPT code
limit integer optional Default is 1000

Networks Endpoint

Endpoint: /v3/networks
Methods: GET

Parameter Data Type Required/Optional Description
region string optional Two letter state abbreviation

Procedures Endpoint

Endpoint: /v3/procedures
Methods: GET

Parameter Data Type Required/Optional Description
q string required partial procedure text
limit integer optional 1000 as default