Health

Data source: Curated dataset (CMS, AHA)

REST Bridge Endpoint https://context.gnist.ai/rest/hospital-directory/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (10)

get_hospital
search_hospitals
list_hospitals_by_state
list_hospitals_by_type
list_hospitals_by_specialty
list_trauma_centers
get_hospital_states
get_hospital_types
get_medical_specialties
report_feedback

get_hospital

Get detailed information about a hospital.

Returns name, location, type, beds, trauma level, specialties, and accreditation.

Parameter	Type	Required	Description
`hospital_id`	`string`	required	Hospital ID slug (e.g. mayo-clinic-rochester, johns-hopkins).

Request Body

{
  "hospital_id": "example"
}

search_hospitals

Search the hospital directory.

Parameter	Type	Required	Description
`query`	`string`	required	Search by name, city, or specialty.
`limit`	`integer`	optional	(default: 20)

Request Body

{
  "query": "example"
}

list_hospitals_by_state

List hospitals in a US state.

Parameter	Type	Required	Description
`state`	`string`	required	US state abbreviation (e.g. MA, CA, NY).
`limit`	`integer`	optional	(default: 50)

Request Body

{
  "state": "example"
}

list_hospitals_by_type

List hospitals by type.

Parameter	Type	Required	Description
`hospital_type`	`string`	required	Hospital type (Teaching, General, Children's, VA).
`limit`	`integer`	optional	(default: 50)

Request Body

{
  "hospital_type": "example"
}

list_hospitals_by_specialty

List hospitals with a given medical specialty.

Parameter	Type	Required	Description
`specialty`	`string`	required	Medical specialty (e.g. Cardiology, Oncology, Neurology).
`limit`	`integer`	optional	(default: 50)

Request Body

{
  "specialty": "example"
}

list_trauma_centers

List trauma centers by level.

Parameter	Type	Required	Description
`level`	`string`	optional	(default: "Level I")
`limit`	`integer`	optional	(default: 50)

Request Body

{
  "query": "example"
}

get_hospital_states

List all US states with hospitals in the directory.

Request Body

{
  "query": "example"
}

get_hospital_types

List all hospital types in the directory.

Request Body

{
  "query": "example"
}

get_medical_specialties

List all medical specialties in the directory.

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/hospital-directory/get_hospital" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"hospital_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/hospital-directory/get_hospital",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "hospital_id": "example"
},
)
print(resp.json())