Save over 30% when you subscribe to an annual subscription plan!

Hospitals API

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

Checking API status...

/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.

Sample Request Live Demo!

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

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.