▸ API · PriceTransparency

REST API

Public read access to hospital negotiated rates, supported billing codes, and per-hospital compliance grades. JSON only. Anonymous calls are rate-limited; higher limits + bulk export via paid tiers (see pricing).

Base URL

https://pricetransparency.io

GET/api/hpt/rates

Look up rates for a billing code, optionally filtered by state, payer, hospital, and rate type.

Query parameters

Name	Type	Description
`code`required	string	CPT/HCPCS/MS-DRG code. Required.
`type`	string	CPT, HCPCS, or MS-DRG. Narrows ambiguous codes.
`state`	string	2-char US state (joined via HCRIS).
`payer`	string	Canonical payer name (e.g. Aetna, Cigna).
`ccn`	string	Filter to one hospital's CMS Certification Number.
`rate_type`	string	gross / cash / negotiated / min / max.
`limit`	int	1..1000, default 100.

Example

curl 'https://pricetransparency.io/api/hpt/rates?code=27447&type=CPT&state=CA&limit=10'

Response

{
  "query": { "code": "27447", "type": "CPT", "state": "CA", "limit": 10 },
  "total_matched": 1284,
  "returned": 10,
  "truncated": true,
  "rows": [
    {
      "ccn": "050167",
      "hospital_name": "Cedars-Sinai Medical Center",
      "state": "CA",
      "city": "Los Angeles",
      "billing_code": "27447",
      "billing_code_type": "CPT",
      "billing_code_description": "Total knee replacement",
      "payer_name_canonical": "Blue Cross Blue Shield",
      "plan_name": "PPO Inpatient",
      "rate_type": "negotiated",
      "rate_amount": 48230.12,
      "snapshot_date": "2026-05-22",
      "source_mrf_url": "https://www.cedars-sinai.org/.../mrf.csv"
    }
  ]
}

GET/api/hpt/codes

List the billing codes PriceTransparency tracks (CMS-mandated shoppables + top MS-DRGs).

Query parameters

Name	Type	Description
`category`	string	imaging / surgery / lab / etc.
`type`	string	CPT, HCPCS, or MS-DRG.

Example

curl 'https://pricetransparency.io/api/hpt/codes?category=imaging'

Response

{
  "total": 64,
  "codes": [
    {
      "billing_code": "70450",
      "billing_code_type": "CPT",
      "short_label": "CT head without contrast",
      "category": "imaging",
      "shoppable_per_cms": true
    }
  ]
}

GET/api/hpt/compliance

Per-hospital compliance grade A-F + score breakdown against CMS-1717-F2 criteria.

Query parameters

Name	Type	Description
`state`	string	2-char US state.
`grade`	string	A / B / C / D / F.
`ccn`	string	Filter to one hospital.
`limit`	int	1..500, default 100.

Example

curl 'https://pricetransparency.io/api/hpt/compliance?grade=A&state=CA'

Response

{
  "query": { "state": "CA", "grade": "A", "limit": 100 },
  "returned": 12,
  "hospitals": [
    {
      "ccn": "050167",
      "hospital_name": "Cedars-Sinai Medical Center",
      "state": "CA",
      "city": "Los Angeles",
      "grade": "A",
      "score": 98,
      "criteria": {
        "discoverable": 15,
        "format": 15,
        "charge_types": 20,
        "descriptions": 10,
        "freshness": 15,
        "shoppable_codes": 15,
        "payer_diversity": 10
      },
      "last_crawl_at": "2026-05-22T17:23:11Z",
      "crawl_status": "success",
      "rows_extracted": 7409
    }
  ]
}

Rate limits + auth

Anonymous calls are limited to 60 requests/minute per IP. For higher limits, bulk exports, and SLA, see paid tiers. API keys are passed as Authorization: Bearer slpk_pricetransparency_….

Data freshness

MRF URLs are refreshed quarterly from each hospital's CMS-mandated cms-hpt.txt. Rate data is recrawled when the URL changes or every 90 days, whichever comes first. The snapshot_date field on each rate row tells you when that specific row was extracted. Hospitals graded F have not yet been crawled — check back as coverage grows.