Duaer

Get started

US hospitals (CMS) in Duaer

In Duaer: Medicare-certified US hospitals from CMS Care Compare: type, ownership, emergency services, and overall star rating. One successful search uses 1 credit.

What you get

Duaer US hospitals (CMS) searches the CMS Care Compare list of Medicare-certified US hospitals, with the CMS overall star rating where one exists.

Pick Duaer Data → US hospitals (CMS) in the node creator, or open the data market. Related: US provider registry (NPI), WHO health statistics.

When to use it

  • Find hospitals in a city or ZIP code with their star rating.
  • Check whether a hospital offers emergency services.

When not to use it

Search on the canvas

  1. Open the node creator and pick Duaer Data → US hospitals (CMS).
  2. Fill Name (such as general), City, State, or ZIP.
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/cms-hospitals?name=general&state=MA
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-cms-hospitals
description: >-
  Duaer US hospitals (CMS). Medicare-certified US hospitals from CMS Care Compare: type, ownership, emergency services, and overall star rating.
  One successful search uses 1 Duaer credit.
---

# Duaer US hospitals (CMS)

Duaer US hospitals (CMS) searches the CMS Care Compare list of Medicare-certified US hospitals, with the CMS overall star rating where one exists.

## When to use

- Find hospitals in a city or ZIP code with their star rating.
- Check whether a hospital offers emergency services.

## When not to use

- Individual clinicians. Use https://skills.duaer.com/npi.md.
- Global health statistics. Use https://skills.duaer.com/who-gho.md.

## Call

`GET https://api.duaer.com/v1/data/cms-hospitals?name=general&state=MA`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `name`, `city`, `state`, or `zip`.

- `name` — Words in the hospital name, such as general.
- `city` — Optional. City, such as Boston.
- `state` — Optional. Two-letter state code, such as MA.
- `zip` — Optional. Five-digit ZIP code, such as 02114.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/cms-hospitals?name=general&state=MA` — general hospitals in Massachusetts.
- `GET https://api.duaer.com/v1/data/cms-hospitals?city=Houston&state=TX&limit=20` — hospitals in Houston.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `facilityId`, `name` — CMS certification number and hospital name.
- `address`, `city`, `state`, `zip`, `county`, `phone` — location.
- `hospitalType`, `ownership`, `emergencyServices` — type, owner, and emergency care.
- `overallRating` — 1 to 5 stars; left out when CMS has no rating.
- `birthingFriendly` — meets the CMS birthing-friendly criteria.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/npi.md — Duaer US provider registry (NPI)
- https://skills.duaer.com/who-gho.md — Duaer WHO health statistics

Questions

How many credits does a US hospitals (CMS) search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Why is the star rating missing for some Duaer US hospitals rows?

When CMS has no overall rating, Duaer US hospitals leaves out overallRating.

In this section

Get started

US provider registry (NPI) in Duaer

In Duaer: US doctors, nurses, clinics, and hospitals in the NPPES NPI registry by name, specialty, and state, with address and license. One successful search uses 1 credit.

Get started

WHO health statistics in Duaer

In Duaer: Country health statistics from the WHO Global Health Observatory: life expectancy, mortality, disease burden, risk factors, and health systems, by year and sex. One successful search uses 1 credit.