List facilities

GET/v1/healthcare/facilitiesLive

Hospitals with their identifiers and locations.

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.

Every facility in the dataset, filterable by state and city. The CCN is the stable identifier — facility names change, CCNs do not.

Parameters

Name	Type	Description
`state`	string	Two-letter code, case-insensitive.
`city`	string	Case-insensitive exact match. Not a prefix search.
`limit`	integer	Rows to return, 1–100. Defaults to 50.

Request

curl

curl "https://api.vemon.io/v1/healthcare/facilities?state=TX&city=Houston" \
  -H "Authorization: Bearer vm_live_…"

Response

200 OK

{
  "scope": { "state": "TX", "city": null },
  "summary": { "facilities": 218, "returned": 50 },
  "data": [
    {
      "ccn": "450565",
      "name": "Palo Pinto General Hospital",
      "city": "Mineral Wells",
      "state": "TX",
      "zip": "76067",
      "procedure_count": 14
    }
  ],
  "has_more": true
}

Errors

invalid_parameter400
not_found404
rate_limit_exceeded429

Full list on the errors page.