{"uid":"cap_s1VIagnqGr_RDIqcaOSQ0","slug":"healthparse-hospital-search-ae2eb80f","name":"HealthParse Hospital Search","description":"Search US hospitals by state, city, type, control, beds, discharges, revenues, or operating margin. Answers: which hospitals in a market match a financial or operational profile? Source: CMS cost reports (HCRIS 2552-10).","url":"https://api.healthparse.io/v1/hospitals/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"city":{"type":"string"},"limit":{"type":"integer","default":25,"maximum":100},"state":{"type":"string"},"offset":{"type":"integer","default":0},"zip_prefix":{"type":"string"},"fy_end_year":{"type":"integer"},"name_search":{"type":"string"},"control_type":{"type":"string"},"hospital_type":{"type":"string"},"total_beds_max":{"type":"number"},"total_beds_min":{"type":"number"},"total_revenues_max":{"type":"number"},"total_revenues_min":{"type":"number"},"operating_margin_max":{"type":"number"},"operating_margin_min":{"type":"number"},"total_discharges_max":{"type":"number"},"total_discharges_min":{"type":"number"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Sia7Pvvx61L3IasPYSyh5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search US hospitals by geographic and financial/operational criteria using CMS HCRIS cost report data","exampleAgentPrompt":"Find me nonprofit acute care hospitals in Texas with at least 100 beds, more than 5,000 discharges, and an operating margin above 5% — pull up to 50 results from the most recent fiscal year.","exampleUseCases":null,"resultDescription":"A paginated list of US hospitals matching the specified filters, each record including hospital name, CCN, location (city, state, ZIP), hospital type, control type, bed count, total discharges, total revenues, and operating margin — all sourced from CMS HCRIS cost reports.","failureModes":["No hospitals match the specified filter combination — returns empty results list","Invalid state abbreviation or unrecognized control_type/hospital_type enum value — may return 400 or empty results","Offset beyond total result count returns empty page","fy_end_year outside available data range returns no results","Rate limit or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need to screen or rank US hospitals by financial or operational criteria across a geographic market — especially when combining location filters (state, city, ZIP) with financial thresholds (revenue, margin, discharges) or facility characteristics (beds, hospital type, control type). Prefer this over the single-hospital history endpoint when you need a broad market overview rather than one institution's time-series. CMS HCRIS data is authoritative for cost and volume metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:11.274Z","isFirstParty":false}