---
title: "Get a Healthgrades hospital profile"
method: GET
path: "/healthgrades/hospital"
tags: ["Healthgrades"]
---

# Get a Healthgrades hospital profile

`GET /healthgrades/hospital`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/healthgrades/hospital`
- Auth: API key in header `x-api-key`

Returns one Healthgrades hospital profile: hospital-wide and specialty awards with years, clinical outcome ratings by service line (procedure or condition, measure, outcome rating, and 1-5 stars), patient-experience measures with national comparisons, address, and phone. Patient-authored reviews are not returned. Requests use US egress because Healthgrades restricts content by region.

## Query parameters

- `url` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HealthgradesHospitalResponseDoc
  - `data` HealthgradesHospitalResponse
    - `address` string
    - `awards` HealthgradesHospitalAward[]
      - `category` string
      - `description` string
      - `name` string
      - `years` integer[]
    - `clinical_ratings` HealthgradesHospitalServiceLine[]
      - `name` string
      - `ratings` HealthgradesHospitalClinicalRating[]
        - `measure` string
        - `procedure_or_condition` string
        - `rating` string: Rating is Healthgrades' outcome label, for example "Better than Expected", "As Expected", or "Worse than Expected" (returned as data).
        - `stars` integer
        - `type` string: Type is the rating family, for example "Complication Based Ratings" or "Mortality Based Ratings" (observed; returned as data).
    - `description` string
    - `name` string
    - `patient_experience` HealthgradesHospitalPatientExperience[]
      - `comparison` string
      - `measure` string
      - `percent` integer
    - `phone` string
    - `url` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)