Seal of Illinois

Illinois Hospital Report Card

and Consumer Guide to Health Care

Hospitals

The hospital model

The hospital model holds hold identifying information and attributes used for location-based searching.

Properties

  • Name
    entity_id
    Type
    int
    Description

    Unique identifier for the hospital.

  • Name
    aha_id
    Type
    int
    Description

    American Hospital Association identifier.

  • Name
    mpn_id
    Type
    int
    Description

    Medicare/Medicaid provider number.

  • Name
    local_id
    Type
    int
    Description

    State of IL license number.

  • Name
    name
    Type
    string
    Description

    Name of the hospital.

  • Name
    address
    Type
    string
    Description

    Street address of the hospital.

  • Name
    city
    Type
    string
    Description

    City of the hospital.

  • Name
    zipcode
    Type
    string
    Description

    Zip code of the hospital.

  • Name
    county_name
    Type
    string
    Description

    County of the hospital.

  • Name
    phone
    Type
    string
    Description

    Phone number of the hospital.

  • Name
    aha_service_id
    Type
    string
    Description

    American Hospital Association service identifier.

  • Name
    ownership
    Type
    string
    Description

    Ownership of the hospital.

  • Name
    geo_lat
    Type
    float
    Description

    Latitude of the hospital.

  • Name
    geo_long
    Type
    float
    Description

    Longitude of the hospital.

  • Name
    website
    Type
    string
    Description

    Website of the hospital.

  • Name
    cha
    Type
    string
    Description

    Community Health Assessment link.

GET /api/hospitals

List all hospitals

This endpoint allows you to retrieve a paginated list of all hospitals. By default, a maximum of fifteen hospitals are shown per page.

Optional attributes

  • Name
    name
    Type
    string
    Description

    Filter hospitals by name.

  • Name
    address
    Type
    string
    Description

    Filter hospitals by address.

  • Name
    city
    Type
    string
    Description

    Filter hospitals by city.

  • Name
    zipcode
    Type
    string
    Description

    Filter hospitals by zipcode.

  • Name
    county_name
    Type
    string
    Description

    Filter hospitals by county_name.

  • Name
    ownership
    Type
    string
    Description

    Filter hospitals by ownership.

  • Name
    per_page
    Type
    int
    Description

    Set number of records returned per page (max 100).

Distance filtering

Filtering by distance requires all three attributes below.

  • Name
    lat
    Type
    float
    Description

    Latitude of the location.

  • Name
    long
    Type
    float
    Description

    Longitude of the location.

  • Name
    radius
    Type
    int
    Description

    Radius in miles to search within.

Request

GET
/api/hospitals

Response
GET /api/hospitals/:entity_id

Retrieve a hospital

This endpoint allows you to retrieve a hospital by providing its entity_id. Refer to the list at the top of this page to see which properties are included with hospital objects.

Request

GET
/api/hospitals/:entity_id

Response
GET /api/hospitals/:entity_id/values

Retrieve values belonging to a hospital

This endpoint allows you to retrieve a values belonging to a specific hospital. Refer to the value docs to see which properties are included with value objects, and available filtering options.

Request

GET
/api/hospitals/:entity_id/values

Response