Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Hospitals API

The Hospitals API provides detailed information about hospitals in the United States including location, contact information, bed count, and more.

(4.5)

From 9,765 users

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
226ms238ms297ms469ms1171ms

Didn't find what you were looking for? Suggest an improvement

/v1/hospitals GET

https://api.api-ninjas.com/v1/hospitals

Get hospital data based on given parameters. Returns a list of hospitals that match the specified criteria.

Parameters

At least one parameter (other than offset) must be provided. Free users are limited to 5 results per request. Premium users can use the limit parameter to get up to 100 results per request and can use the offset parameter to paginate through more results.

  • name  optional

    Name of the hospital to search for. Supports partial matching.

  • city  optional

    City where the hospital is located.

  • state  optional

    State where the hospital is located.

  • zipcode  optional

    ZIP code of the hospital location.

  • county  optional

    County where the hospital is located.

  • min_latitude  optional

    Minimum latitude coordinate.

  • max_latitude  optional

    Maximum latitude coordinate.

  • min_longitude  optional

    Minimum longitude coordinate.

  • max_longitude  optional

    Maximum longitude coordinate.

  • limit  optional premium only

    Number of results to return. Default is 5. Maximum is 100.

  • offset  optional premium only

    Number of results to skip. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of hospital objects. Each object may contain:

  • name

    Hospital name.

  • care_type

    Type of care (for example Acute Care Hospitals).

  • address, city, state, zipcode

    Mailing address fields of the hospital.

  • county

    County where it is located.

  • location_area_code

    Telephone area code.

  • fips_code

    FIPS (Federal Information Processing Standard) county code.

  • timezone

    Local timezone for the site.

  • latitude, longitude

    Geographic coordinates of the hospital.

  • phone_number

    Main contact phone number in string format.

  • website

    Hospital website URL.

  • ownership

    Ownership / operator type (for example Voluntary non-profit - Private).

  • bedcount

    Number of staffed beds.

Sample Request Live Demo!

name
city
state
zipcode
county

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/hospitals?name=General%20Hospital

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 [ { "name": "ROCHESTER GENERAL HOSPITAL", "care_type": "Acute Care Hospitals", "address": "1425 Portland Ave", "city": "Rochester", "state": "NY", "zipcode": "14621", "county": "Monroe", "location_area_code": "585", "fips_code": "36055", "timezone": "EST", "latitude": "43.1888", "longitude": "-77.6040", "phone_number": "(585) 922-4000", "website": "http://www.viahealth.org/", "ownership": "Voluntary non-profit - Private", "bedcount": 398 }, "..." ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/hospitals?name=General%20Hospital" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.