List prices

GET/v1/healthcare/pricesLive

Submitted charges and Medicare allowed amounts by facility.

Authentication

This endpoint requires an API key, as every endpoint does. Keys are issued on signup — the free trial needs no card. See authentication for key handling, or view the data first in the Explorer.

Returns one row per facility for a given procedure group, ordered by submitted charge ascending. The summary block covers every matching facility, not just the page returned.

Parameters

Name	Type	Description
`procedure` required	string	APC code identifying the procedure group.
`state`	string	Two-letter code, case-insensitive. Omit for national results. An unrecognised code returns 400 with the list of valid values.
`limit`	integer	Rows to return, 1–50. Defaults to 25.

Request

curl

curl "https://api.vemon.io/v1/healthcare/prices?procedure=5372&state=CA&limit=25" \
  -H "Authorization: Bearer vm_live_…"

Response

200 OK

{
  "procedure": {
    "code": "5372",
    "name": "Level 2 Urology and Related Services"
  },
  "scope": { "state": "national" },
  "summary": {
    "facilities": 848,
    "median_charge": 3137,
    "min_charge": 262,
    "max_charge": 52123,
    "spread": 198.9
  },
  "data": [
    {
      "facility": "Northern Maine Medical Center",
      "city": "Fort Kent",
      "state": "ME",
      "ccn": "200052",
      "submitted_charge": 262,
      "medicare_allowed": 628
    }
  ],
  "source": { "data_year": 2024, "caveat": "…" }
}

Errors

missing_parameter400
invalid_parameter400
not_found404
rate_limit_exceeded429

Full list on the errors page.