Healthcare Price Transparency API - Negotiated & Cash Prices

Compare what a shoppable procedure costs across US hospitals, surgery centers and imaging centers: negotiated insurance rates by payer network and cash (self pay) prices from the Turquoise Health Consumer Pricing API, with your own API credentials, as one clean dataset row per price.

Turquoise Health builds its Clear Rates database from the machine readable files hospitals and insurers publish under the US price transparency rules, cross checks the rates against paid claims, and bundles billing codes into service packages that match how care is actually billed. This actor wraps the read only routes of its Consumer Pricing API v3 on api.turquoise.health: give a service package such as a knee MRI and a ZIP code, and get every priced provider nearby with its package total, cheapest or nearest first, plus price statistics and the provider, payer, network and package directories. Download the rows as JSON, CSV or Excel, schedule runs, or feed them into care navigation tools, benefits platforms, referral workflows, employer cost analysis, Google Sheets and AI agents. Bring your own API key.

BYOK, not live-tested: every path, parameter and enum comes from the published Turquoise Health OpenAPI document (version 3.2.105), but the actor has not been run against live Turquoise Health credentials.

What it does

• Price search (negotiated or cash): the package total for one service package at every matching provider, under one payer network's negotiated rate or as the cash price. Filter to one provider, or to providers near coordinates (with a radius), around a ZIP code, in a state, a metro area (CBSA) or a list of ZIP codes. Sort by total price or distance. Paged.
• Price statistics: the count, minimum, first quartile, median, average, third quartile and maximum of the same prices, in one row, for comparing a market or a network at a glance.
• Price by ID: single prices, optionally with the billing line items (CPT and HCPCS codes, fee types, association rates) that make up the package.
• Provider search and provider by ID: hospitals, ambulatory surgery centers, imaging centers and other facilities by name, NPI, provider type, semantic search, location, and whether they have prices for a package, payer or network.
• Payer, network and service package search: the insurers, payer networks and shoppable service packages with prices in the data, and the IDs the price modes take. Package search also finds the package built on a CPT or HCPCS code.
• Provider types and package line items: the valid provider type values, and the codes inside any package.
• Pay only for results: refused and empty lookups are recorded as a free row that says why, never charged.

Nothing in your Turquoise Health account is changed. The personalized estimate routes, which take a named member's identity, date of birth and member ID, are deliberately not wrapped.

How to get API credentials

Turquoise Health issues API credentials to customers: a client id, a client secret and an organization id. A free demo account gives test credentials; production access comes through Turquoise Health sales. Paste all three into the credential fields (or set the DATA_API_CLIENT_ID, DATA_API_KEY and DATA_API_ORGANIZATION_ID secrets). The actor exchanges them once per run for an access token at api.turquoise.health/oauth/token, as the documentation describes, and reuses it. You can also paste a ready access token into the Client secret field and leave the client id empty. Secrets are sent only to Turquoise Health and are removed from everything the actor logs.

Input

Field	Modes	Description
mode	all	priceSearch (default), priceStatistics, priceById, providerSearch, providerById, providerTypes, payerSearch, networkSearch, packageSearch or packageLineItems
packageId	price search, price statistics (required); provider, payer, network search	Service package ID such as RA005 (knee MRI)
pricingType	price search, price statistics	cash (default) or negotiated
networkId	negotiated pricing (required); provider, package search	Payer network ID such as -3776001016975145508
providerId	price search, price statistics; payer, network, package search	One facility
payerId	provider, network, package search	One insurer
sort, sortDirection	price search	total or distance; asc or desc
zip, latLng, radiusMiles, state, cbsa, zipCodes	price search, price statistics; provider, payer, network search	One location only
ids, expandLineItems	price by ID, provider by ID, package line items	Up to 500 IDs a run
name, searchText, minScore	provider, payer, network, package search	Substring and semantic search
npi, providerType	provider search	Exact facility NPI and type
anchorCode	package search	CPT or HCPCS code such as 73721
maxResults	all	Row ceiling for the run (default 100)
requestsPerMinute	all	Pacing, default 60
clientId, apiKey, organizationId	all	Your Turquoise Health credentials (or a ready access token in apiKey)

Example: cash prices for a knee MRI near downtown Denver, nearest first.

{
    "mode": "priceSearch",
    "packageId": "RA005",
    "pricingType": "cash",
    "zip": "80202",
    "sort": "distance",
    "maxResults": 50
}

Example: negotiated rates for the same MRI under one payer network, statewide.

{
    "mode": "priceSearch",
    "packageId": "RA005",
    "pricingType": "negotiated",
    "networkId": "-3776001016975145508",
    "state": "CO"
}

Example output

One price search row (the full Turquoise Health record is kept under record):

{
    "mode": "priceSearch",
    "modeLabel": "Price search",
    "recordType": "price",
    "query": "package=RA005 pricing=cash location=80202",
    "id": "p_5754_RA005_cash",
    "name": "MRI of the Knee at Example Imaging Center",
    "providerId": "5754",
    "providerName": "Example Imaging Center",
    "providerType": "Imaging Center",
    "npi": "1234567890",
    "city": "Denver",
    "state": "CO",
    "zip": "80218",
    "latitude": 39.7316,
    "longitude": -104.9714,
    "distanceMiles": 1.42,
    "packageId": "RA005",
    "packageName": "MRI of the Knee",
    "pricingType": "cash",
    "networkId": null,
    "networkName": null,
    "payerId": null,
    "payerName": null,
    "totalPrice": 650,
    "currency": "USD",
    "lineItemCount": null,
    "found": true,
    "retrievedAt": "2026-10-21T09:00:00.000Z",
    "note": null,
    "record": { "object": "price", "id": "p_5754_RA005_cash", "total": { "amount": "650.00", "minor_units": 65000, "currency": "USD" } }
}

A price statistics row carries count, priceMin, priceQ1, priceMedian, priceAvg, priceQ3 and priceMax instead. Values above are illustrative.

FAQ

What is the Turquoise Health Consumer Pricing API?

It is Turquoise Health's REST API for healthcare prices: negotiated commercial rates (its Clear Rates data, refreshed monthly) and cash prices for about 70 shoppable service packages, across roughly 14,000 hospitals, ambulatory surgery centers and imaging centers, 96 payers and 292 payer networks in all 50 states and DC, according to its documentation.

Do I need my own Turquoise Health credentials?

Yes. This actor is bring your own key: it runs on the client id, client secret and organization id Turquoise Health issued you, or a ready access token. Without them the run ends straight away with a message saying what to add, and nothing is charged.

How do I compare hospital prices for a procedure near me?

Find the service package with Service package search (for example name MRI or billing code 73721), then run Price search with that package ID, a ZIP code and sort total for the cheapest providers first, or sort distance for the nearest.

How do I get negotiated insurance rates for a health plan?

Run Network search with the insurer's name (for example Cigna) to get its network IDs, then Price search with pricing type negotiated and that network ID. Each row is the package total that network has negotiated with one provider.

What is the difference between cash and negotiated prices?

A cash price is what the facility charges a self pay patient. A negotiated rate is the price an insurer's network agreed with the facility; it is the allowed amount before the member's deductible and coinsurance, not the member's out of pocket cost.

What is a service package?

A bundle of the billing codes that are usually billed together for one service, such as the imaging code plus facility and professional fees for a knee MRI. Package line items lists those codes with their fee type and how likely each is to be part of the package.

How many API requests does a run use?

One per ID, one per page in the paged searches (page size up to 250, matched to Maximum results), one for price statistics, plus one token request when you give a client id. A semantic search is always a single page. The run log reports the exact request count.

What do I pay?

Pay per result: 0.015 USD per price, 0.01 USD per price statistics summary, and 0.005 USD per provider, provider type, payer, network, package or line item. Refused and empty lookups are never charged. Your Turquoise Health contract is billed separately by Turquoise Health.

Pricing

Event	Price	Charged for
price-record	0.015 USD	Each negotiated rate or cash price from price search or price by ID
price-statistics	0.01 USD	Each price statistics summary
directory-record	0.005 USD	Each provider, provider type, payer, network, service package or package line item

Keyword map

Healthcare price transparency API, hospital price transparency data, negotiated rates API, insurance negotiated rates, cash price lookup, self pay prices, procedure cost comparison, MRI cost, colonoscopy price, CPT price lookup, shoppable services, Transparency in Coverage data, machine readable files, payer network rates, Turquoise Health API, Clear Rates, healthcare pricing data, care navigation, employer health cost analysis, AI healthcare cost agent.

Terms and data use

Access to the Turquoise Health API is governed by your agreement with Turquoise Health. Its Master Subscription Agreement limits use to the customer's internal business purposes and bars using the service to build a competing product, so run this actor with your own credentials, keep the results for the uses your agreement allows, and do not publish or resell them without written permission from Turquoise Health. Turquoise Health notes that IDs can change when its data is refreshed, so read IDs fresh rather than storing them long term. Prices are estimates for informational purposes, not quotes or medical advice. This actor is not affiliated with or endorsed by Turquoise Health.