{"uid":"cap_06Vzs25z3OJeAmY51FsVj","slug":"cms-hospital-general-information-by-state-1cc8c223","name":"CMS Hospital General Information by State","description":"CMS Hospital General Information (data.cms.gov): hospital name, city, type, ownership, emergency services, overall star rating (1-5, when CMS publishes one) and counts of measures better, no different or worse than the national rate for mortality, safety and readmission. Up to 50 hospitals per state per call.","url":"https://api.healthtravel-api.workers.dev/api/health/hospitallink-cms-ratings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["state"],"properties":{"max":{"type":"string","description":"How many hospitals, 1 to 50 (default 10)"},"state":{"type":"string","description":"Two-letter US state code, e.g. VT"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"via":"csv","state":"VT","source":"https://data.cms.gov/provider-data/dataset/xubh-q36u","checkedAt":"2026-10-23T09:36:38.123Z","hospitals":[{"city":"BARRE","name":"CENTRAL VERMONT MEDICAL CENTER","type":"Acute Care Hospitals","phone":"(802) 371-4100","state":"VT","measures":{"safety":{"worse":1,"better":0,"noDifferent":4},"mortality":{"worse":0,"better":1,"noDifferent":5},"readmission":{"worse":2,"better":0,"noDifferent":7}},"ownership":"Voluntary non-profit - Private","facilityId":"470001","overallStars":3,"emergencyServices":true},{"city":"BURLINGTON","name":"UNIV. OF VERMONT - FLETCHER ALLEN HEALTH CARE","type":"Acute Care Hospitals","phone":"(802) 847-0000","state":"VT","measures":{"safety":{"worse":1,"better":2,"noDifferent":5},"mortality":{"worse":0,"better":2,"noDifferent":6},"readmission":{"worse":3,"better":1,"noDifferent":7}},"ownership":"Voluntary non-profit - Other","facilityId":"470003","overallStars":4,"emergencyServices":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j-4xHonTPm75I37E81nbE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns CMS hospital general information including name, type, ownership, emergency services, star ratings, and quality measure counts for up to 50 hospitals in a given US state.","exampleAgentPrompt":"Can you pull up CMS hospital ratings for all hospitals in Vermont — I want to see their star ratings, emergency services status, and how they compare to the national rate for mortality and safety? Show me up to 20 hospitals.","exampleUseCases":[{"title":"Hospital quality research by state","prompt":"I'm researching hospital quality in Texas — can you get me CMS star ratings and safety measure comparisons for up to 50 hospitals there?"},{"title":"Finding top-rated emergency hospitals","prompt":"Which hospitals in Massachusetts have emergency services and a CMS overall star rating of 4 or 5? Pull the full list with their mortality and readmission measure counts."},{"title":"Healthcare coverage gap analysis","prompt":"I need to understand the hospital landscape in Wyoming — can you fetch CMS general info for all hospitals there, including ownership type and whether they have emergency services?"}],"resultDescription":"A JSON object containing the queried state, data source URL, timestamp, and an array of hospital records. Each record includes the hospital name, city, state, phone, facility ID, type, ownership, emergency services flag, overall CMS star rating (1-5 when published), and measure counts for mortality, safety, and readmission (broken into better, no different, and worse than national rate).","failureModes":["Missing or invalid state code returns an error or empty result","CMS may not publish an overall star rating for all hospitals, resulting in null overallStars","Some hospitals may lack measure data for certain categories","Max parameter outside 1-50 range may cause validation errors","Data freshness depends on CMS publication schedule; may not reflect the most recent quarter"],"whenToPreferThis":"Choose this endpoint when you need structured CMS hospital quality data for a specific US state, including star ratings and national-rate comparisons for mortality, safety, and readmission. Prefer it over raw CMS data downloads when you need a lightweight, per-state API call without parsing large CSVs. Best for agents doing hospital discovery, quality benchmarking, or healthcare coverage analysis at the state level.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:56.951Z","isFirstParty":false,"canonicalSlug":"cms-hospital-general-information-by-state-1cc8c223"}