List procedures

GET/v1/healthcare/proceduresLive

Procedure groups with coverage and price distribution.

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.

The APC classifications present in the dataset, with how many facilities report each and the charge distribution across them. Use this to find a procedure code before querying prices.

Parameters

Name	Type	Description
`min_facilities`	integer	Only return groups reported by at least this many facilities. Filters out thin coverage.
`sort`	string	One of coverage, spread, median. Defaults to coverage. Anything else returns 400.
`limit`	integer	Rows to return, 1–100. Defaults to 50.

Request

curl

curl "https://api.vemon.io/v1/healthcare/procedures?min_facilities=200&sort=spread" \
  -H "Authorization: Bearer vm_live_…"

Response

200 OK

{
  "scope": { "min_facilities": 200, "sort": "spread" },
  "summary": { "procedures": 45, "returned": 45 },
  "data": [
    {
      "code": "5372",
      "name": "Level 2 Urology and Related Services",
      "facility_count": 848,
      "median_charge": 3137,
      "min_charge": 262,
      "max_charge": 52123,
      "spread": 198.9
    }
  ]
}

Errors

invalid_parameter400
not_found404
rate_limit_exceeded429

Full list on the errors page.