{"openapi":"3.1.0","info":{"title":"US Hospitals API","version":"1.0.0","description":"Search and filter more than 5,400 Medicare-certified hospitals across the United States and territories: filter by state, city, free-text name, hospital type (acute care, critical access, psychiatric, childrens, veterans and more), ownership category, whether the hospital offers emergency services, and the CMS overall star rating. Look up any hospital by its CMS facility id, and read metadata listing every state with its hospital count plus the available types and ownership categories for building filter UIs. Each record returns the facility id, name, full address, county, phone number, type, ownership, emergency-services flag and overall rating. Built on the official CMS Hospital General Information dataset. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side data (no third-party upstream), so responses are instant and always available. Ideal for healthcare directories, patient-facing apps, insurance and care-navigation tools, and research.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hospitals-api","description":"oanor gateway"}],"tags":[{"name":"Hospitals"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/hospital":{"get":{"operationId":"get_v1_hospital","tags":["Hospitals"],"summary":"Single hospital by CMS facility id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"CMS facility id","schema":{"type":"string"},"example":"050441"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"050441","zip":"94305","city":"STANFORD","name":"STANFORD HEALTH CARE","type":"Acute Care Hospitals","phone":"(650) 723-4000","state":"CA","county":"SANTA CLARA","address":"300 PASTEUR DRIVE","ownership":"Voluntary non-profit - Private","overall_rating":5,"emergency_services":true},"meta":{"timestamp":"2026-05-30T22:48:26.442Z","request_id":"7e441492-3532-41b1-8195-465afe64337b"},"status":"ok","message":"Hospital retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Hospitals"],"summary":"States, types & ownership facets","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"rated":3182,"total":5432,"types":["Acute Care - Department of Defense","Acute Care - Veterans Administration","Acute Care Hospitals","Childrens","Critical Access Hospitals","Long-term","Psychiatric","Rural Emergency Hospital"],"states":[{"state":"AK","hospitals":25},{"state":"AL","hospitals":100},{"state":"AR","hospitals":91},{"state":"AS","hospitals":1},{"state":"AZ","hospitals":107},{"state":"CA","hospitals":378},{"state":"CO","hospitals":97},{"state":"CT","hospitals":36},{"state":"DC","hospitals":10},{"state":"DE","hospitals":13},{"state":"FL","hospitals":221},{"state":"GA","hospitals":149},{"state":"GU","hospitals":2},{"state":"HI","hospitals":24},{"state":"IA","hospitals":118},{"state":"ID","hospitals":48},{"state":"IL","hospitals":194},{"state":"IN","hospitals":151},{"state":"KS","hospitals":138},{"state":"KY","hospitals":103},{"state":"LA","hospitals":161},{"state":"MA","hospitals":84},{"state":"MD","hospitals":56},{"state":"ME","hospitals":36},{"state":"MI","hospitals":148},{"state":"MN","hospitals":136},{"state":"MO","hospitals":121},{"state":"MP","hospitals":1},{"state":"MS","hospitals":108},{"state":"MT","hospitals":63},{"state":"NC","hospitals":120},{"state":"ND","hospitals":47},{"state":"NE","hospitals":93},{"state":"NH","hospitals":28},{"state":"NJ","hospitals":79},{"state":"NM","hospitals":45},{"state":"NV","hospitals":46},{"state":"NY","hospitals":191},{"state":"OH","hospitals":196},{"state":"OK","hospitals":135},{"state":"OR","hospitals":62},{"state":"PA","hospitals":187},{"state":"PR","hospitals":60},{"state":"RI","hospitals":13},{"state":"SC","hospitals":66},{"state":"SD","hospitals":61},{"state":"TN","hospitals":122},{"state":"TX","hospitals":468},{"state":"UT","hospitals":52},{"state":"VA","hospitals":96},{"state":"VI","hospitals":2},{"state":"VT","hospitals":17},{"state":"WA","hospitals":100},{"state":"WI","hospitals":141},{"state":"WV","hospitals":55},{"state":"WY","hospitals":30}],"ownerships":["Department of Defense","Government - Federal","Government - Hospital District or Authority","Government - Local","Government - State","Physician","Proprietary","Tribal","Veterans Health Administration","Voluntary non-profit - Church","Voluntary non-profit - Other","Voluntary non-profit - Private"]},"meta":{"timestamp":"2026-05-30T22:48:26.515Z","request_id":"4967ca8d-4dca-4063-b171-19e0baa1eb96"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Hospitals"],"summary":"Search & filter hospitals","description":"","parameters":[{"name":"state","in":"query","required":false,"description":"2-letter state code","schema":{"type":"string"},"example":"CA"},{"name":"city","in":"query","required":false,"description":"City","schema":{"type":"string"},"example":"san diego"},{"name":"q","in":"query","required":false,"description":"Name/free text","schema":{"type":"string"},"example":"mayo"},{"name":"type","in":"query","required":false,"description":"acute|critical access|psychiatric|...","schema":{"type":"string"},"example":"acute"},{"name":"ownership","in":"query","required":false,"description":"Ownership category","schema":{"type":"string"},"example":"voluntary"},{"name":"min_rating","in":"query","required":false,"description":"Min CMS star rating 1..5","schema":{"type":"string"},"example":"4"},{"name":"emergency","in":"query","required":false,"description":"Emergency services true/false","schema":{"type":"string"},"example":"true"},{"name":"limit","in":"query","required":false,"description":"1..100 (default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":0,"limit":20,"total":0,"offset":0,"filters":{"q":"mayo","city":"san diego","type":"acute","state":"CA","emergency":true,"ownership":"voluntary","min_rating":4},"results":[]},"meta":{"timestamp":"2026-05-30T22:48:26.566Z","request_id":"21bd03a0-1b1b-47af-95e3-8cc86b8aa6ea"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":22000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":680,"monthly_call_quota":300000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":2200000,"rps_limit":45,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5400,"monthly_call_quota":9000000,"rps_limit":130,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hospitals-api"}