Health Facility General Information API

This featured Application Programming Interface (API) page serves as a reference for developers who are building tools that interact with the data on Health Data NY. The page provides examples on how to retrieve data from each of the fields within the dataset. A description of each field is also provided. This specific API page is for the Health Facility General Information dataset. This dataset contains the locations of Article 28, Article 36 and Article 40 health care facilities and programs from the Health Facilities Information System (HFIS). Article 28 facilities are hospitals, nursing homes, and diagnostic treatment centers. Article 36 facilities are certified home health care agencies and long term home health care programs. Article 40 facilities are hospices. The dataset currently only contains the locations of hospitals and hospital extension clinics. The data for the remaining facility types will be added in the future. While the NYS Department of Health makes every effort to post accurate and reliable information, it does not guarantee or warrant that the information in this dataset is complete, accurate or up-to-date. If you have more reliable data than what is presented here, please send an update request to hfismb@health.state.ny.us . Please include facility name and FAC ID in the subject of correspondence. For more information, go to the "About" tab. This dataset is available at: https://health.data.ny.gov/dataset/Health-Facility-General-Information/vn5v-hh5r. For more information abou the dataset, go to the dataset and look in the "About" section.

Getting Started

All communication with the API is done through HTTPS, and errors are communicated through HTTP response codes. Available response types include JSON, XML, and CSV, which are selectable by the "extension" on API requests or by HTTP Accepts headers.

This documentation also includes inline, runable examples. Click on any link that contains a gear symbol next to it to run that example live against the Health Facility General Information API API.

App Tokens

All requests should include an app token that identifies your application, and each application should have its own unique app token. A limited number of requests can be made without an app token, but they are subject to much lower throttling limits than request that do include one. If you don't have an app token yet, click the button to the right to sign up for one.

Once you have an app token, you can include it with your request either by using the X-App-Token HTTP header, or by passing it via the $app_token parameter on your URL.

Response Codes

One of the following response codes will be returned with every request:

  1. 200Successful request.
  2. 202Request processing. You can retry your request, and when it's complete, you'll get a 200 instead.
  3. 400Bad request
  4. 401Unauthorized. You're not authorized to access this resource.
  5. 404Not found. The resource requested doesn't exist.
  6. 429Too Many Requests. The client has made too many requests and is currently being rate limited.
  7. 500Server errors. Our bad!

Code Samples

#!/usr/bin/env ruby

require 'net/https'
uri = URI('https://health.data.ny.gov/resource/health-facility-general-information.json?recall_id=94')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER

request = Net::HTTP::Get.new(uri.request_uri)
request.add_field('X-App-Token', ARGV[0])

response = http.request(request)
puts response.code
puts response.body
#!/usr/bin/env python

import sys
import requests

r = requests.get('https://health.data.ny.gov/resource/health-facility-general-information.json?recall_id=94', headers={'X-App-Token': sys.argv[1]})
print r.status_code
print r.text
request = require 'request'
options = uri: 'https://health.data.ny.gov/resource/health-facility-general-information.json?$$app_token=APP_TOKEN&recall_id=94'
request options, (err, response, body) ->  console.log body
#!/bin/sh 

curl --header "X-App-Token: $1" "https://health.data.ny.gov/resource/health-facility-general-information.json?recall_id=94"

Fields

The following fields are available on the Health Facility General Information API API.

fac_id

Human Name: Facility ID
Type: number
Site specific facility identification number.

Examples

Retrieve all records with fac_id equal to {column.cachedContents.largest}:
Retrieve all records with fac_id equal to {column.cachedContents.largest}:

Retrieve all records where fac_id is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_id, 47.598177,-122.33448, 1000)

facility_name

Human Name: Facility Name
Type: text
Current facility name.

Examples

Retrieve all records with facility_name equal to {column.cachedContents.largest}:
Retrieve all records with facility_name equal to {column.cachedContents.largest}:

Retrieve all records where facility_name is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(facility_name, 47.598177,-122.33448, 1000)

fac_desc_short

Human Name: Short Description
Type: text
Abbreviated name for type of facility.

Examples

Retrieve all records with fac_desc_short equal to {column.cachedContents.largest}:
Retrieve all records with fac_desc_short equal to {column.cachedContents.largest}:

Retrieve all records where fac_desc_short is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_desc_short, 47.598177,-122.33448, 1000)

description

Human Name: Description
Type: text
Type of facility.

Examples

Retrieve all records with description equal to {column.cachedContents.largest}:
Retrieve all records with description equal to {column.cachedContents.largest}:

Retrieve all records where description is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(description, 47.598177,-122.33448, 1000)

fac_opn_dat

Human Name: Facility Open Date
Date facility opened.

Examples

Retrieve all records with fac_opn_dat equal to {column.cachedContents.largest}:
Retrieve all records with fac_opn_dat equal to {column.cachedContents.largest}:

Retrieve all records where fac_opn_dat is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_opn_dat, 47.598177,-122.33448, 1000)

address1

Human Name: Facility Address 1
Type: text
Address Line 1 of facility.

Examples

Retrieve all records with address1 equal to {column.cachedContents.largest}:
Retrieve all records with address1 equal to {column.cachedContents.largest}:

Retrieve all records where address1 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(address1, 47.598177,-122.33448, 1000)

address2

Human Name: Facility Address 2
Type: text
Address Line 2 of facility (if applicable).

Examples

Retrieve all records with address2 equal to {column.cachedContents.largest}:
Retrieve all records with address2 equal to {column.cachedContents.largest}:

Retrieve all records where address2 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(address2, 47.598177,-122.33448, 1000)

city

Human Name: Facility City
Type: text
City of facility.

Examples

Retrieve all records with city equal to {column.cachedContents.largest}:
Retrieve all records with city equal to {column.cachedContents.largest}:

Retrieve all records where city is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(city, 47.598177,-122.33448, 1000)

state

Human Name: Facility State
Type: text
State of facility (always New York State).

Examples

Retrieve all records with state equal to {column.cachedContents.largest}:
Retrieve all records with state equal to {column.cachedContents.largest}:

Retrieve all records where state is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(state, 47.598177,-122.33448, 1000)

fac_zip

Human Name: Facility Zip Code
Type: text
Zip Code of facility.

Examples

Retrieve all records with fac_zip equal to {column.cachedContents.largest}:
Retrieve all records with fac_zip equal to {column.cachedContents.largest}:

Retrieve all records where fac_zip is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_zip, 47.598177,-122.33448, 1000)

fac_phone

Human Name: Facility Phone Number
Type: text
Phone Number of facility.

Examples

Retrieve all records with fac_phone equal to {column.cachedContents.largest}:
Retrieve all records with fac_phone equal to {column.cachedContents.largest}:

Retrieve all records where fac_phone is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_phone, 47.598177,-122.33448, 1000)

fac_fax

Human Name: Facility Fax Number
Type: text
Fax Number of facility.

Examples

Retrieve all records with fac_fax equal to {column.cachedContents.largest}:
Retrieve all records with fac_fax equal to {column.cachedContents.largest}:

Retrieve all records where fac_fax is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(fac_fax, 47.598177,-122.33448, 1000)

web_site

Human Name: Facility Website
Type: url
Website of Facility.

Examples

Retrieve all records with web_site equal to {column.cachedContents.largest}:
Retrieve all records with web_site equal to {column.cachedContents.largest}:

Retrieve all records where web_site is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(web_site, 47.598177,-122.33448, 1000)

cnty_cd

Human Name: Facility County Code
Type: number
Gazetteer Code for County facility is located in.

Examples

Retrieve all records with cnty_cd equal to {column.cachedContents.largest}:
Retrieve all records with cnty_cd equal to {column.cachedContents.largest}:

Retrieve all records where cnty_cd is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cnty_cd, 47.598177,-122.33448, 1000)

county

Human Name: Facility County
Type: text
County where facility is located.

Examples

Retrieve all records with county equal to {column.cachedContents.largest}:
Retrieve all records with county equal to {column.cachedContents.largest}:

Retrieve all records where county is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(county, 47.598177,-122.33448, 1000)

ro_id

Human Name: Regional Office ID
Type: number
Identification number of NYSDOH Regional Office.

Examples

Retrieve all records with ro_id equal to {column.cachedContents.largest}:
Retrieve all records with ro_id equal to {column.cachedContents.largest}:

Retrieve all records where ro_id is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(ro_id, 47.598177,-122.33448, 1000)

region_office

Human Name: Regional Office
Type: text
Name of NYSDOH Regional Office for facility.

Examples

Retrieve all records with region_office equal to {column.cachedContents.largest}:
Retrieve all records with region_office equal to {column.cachedContents.largest}:

Retrieve all records where region_office is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(region_office, 47.598177,-122.33448, 1000)

main_site_name

Human Name: Main Site Name
Type: text
Name of facility's main site, if facility is an extension clinic.

Examples

Retrieve all records with main_site_name equal to {column.cachedContents.largest}:
Retrieve all records with main_site_name equal to {column.cachedContents.largest}:

Retrieve all records where main_site_name is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(main_site_name, 47.598177,-122.33448, 1000)

main_site_facid

Human Name: Main Site Facility ID
Type: number
Facility identification number of main site, if facility is an extension clinic.

Examples

Retrieve all records with main_site_facid equal to {column.cachedContents.largest}:
Retrieve all records with main_site_facid equal to {column.cachedContents.largest}:

Retrieve all records where main_site_facid is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(main_site_facid, 47.598177,-122.33448, 1000)

opcert_num

Human Name: Operating Certificate Number
Type: text
Operating Certificate number for facility.

Examples

Retrieve all records with opcert_num equal to {column.cachedContents.largest}:
Retrieve all records with opcert_num equal to {column.cachedContents.largest}:

Retrieve all records where opcert_num is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(opcert_num, 47.598177,-122.33448, 1000)

operator_name

Human Name: Operator Name
Type: text
Name of the current operator of facility.

Examples

Retrieve all records with operator_name equal to {column.cachedContents.largest}:
Retrieve all records with operator_name equal to {column.cachedContents.largest}:

Retrieve all records where operator_name is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_name, 47.598177,-122.33448, 1000)

operator_address1

Human Name: Operator Address 1
Type: text
Address Line 1 of the current operator.

Examples

Retrieve all records with operator_address1 equal to {column.cachedContents.largest}:
Retrieve all records with operator_address1 equal to {column.cachedContents.largest}:

Retrieve all records where operator_address1 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_address1, 47.598177,-122.33448, 1000)

operator_address2

Human Name: Operator Address 2
Type: text
Address Line 2 of the current operator (if applicable).

Examples

Retrieve all records with operator_address2 equal to {column.cachedContents.largest}:
Retrieve all records with operator_address2 equal to {column.cachedContents.largest}:

Retrieve all records where operator_address2 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_address2, 47.598177,-122.33448, 1000)

operator_city

Human Name: Operator City
Type: text
City of current operator.

Examples

Retrieve all records with operator_city equal to {column.cachedContents.largest}:
Retrieve all records with operator_city equal to {column.cachedContents.largest}:

Retrieve all records where operator_city is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_city, 47.598177,-122.33448, 1000)

operator_state

Human Name: Operator State
Type: text
State of current operator.

Examples

Retrieve all records with operator_state equal to {column.cachedContents.largest}:
Retrieve all records with operator_state equal to {column.cachedContents.largest}:

Retrieve all records where operator_state is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_state, 47.598177,-122.33448, 1000)

operator_zip

Human Name: Operator ZIp Code
Type: text
Zip Code of current operator.

Examples

Retrieve all records with operator_zip equal to {column.cachedContents.largest}:
Retrieve all records with operator_zip equal to {column.cachedContents.largest}:

Retrieve all records where operator_zip is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(operator_zip, 47.598177,-122.33448, 1000)

cooperator_name

Human Name: Cooperator Name
Type: text
Name of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_name equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_name equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_name is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_name, 47.598177,-122.33448, 1000)

cooperator_address1

Human Name: Cooperator Address
Type: text
Address Line 1 of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_address1 equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_address1 equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_address1 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_address1, 47.598177,-122.33448, 1000)

cooperator_address2

Human Name: Cooperator Address 2
Type: text
Address Line 2 of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_address2 equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_address2 equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_address2 is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_address2, 47.598177,-122.33448, 1000)

cooperator_city

Human Name: Cooperator City
Type: text
City of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_city equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_city equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_city is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_city, 47.598177,-122.33448, 1000)

cooperator_state

Human Name: Cooperator State
Type: text
State of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_state equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_state equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_state is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_state, 47.598177,-122.33448, 1000)

cooperator_zip

Human Name: Cooperator Zip Code
Type: text
Zip Code of current cooperator (if applicable).

Examples

Retrieve all records with cooperator_zip equal to {column.cachedContents.largest}:
Retrieve all records with cooperator_zip equal to {column.cachedContents.largest}:

Retrieve all records where cooperator_zip is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(cooperator_zip, 47.598177,-122.33448, 1000)

latitude

Human Name: Facility Latitude
Type: number
System for representing healthcare facilities on map. Geo-coded to mailing address.

Examples

Retrieve all records with latitude equal to {column.cachedContents.largest}:
Retrieve all records with latitude equal to {column.cachedContents.largest}:

Retrieve all records where latitude is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(latitude, 47.598177,-122.33448, 1000)

longitude

Human Name: Facility Longitude
Type: number
System for representing healthcare facilities on map. Geo-coded to mailing address.

Examples

Retrieve all records with longitude equal to {column.cachedContents.largest}:
Retrieve all records with longitude equal to {column.cachedContents.largest}:

Retrieve all records where longitude is within 1 kilometer of Seattle, WA (47.598177,-122.33448):

https://health.data.ny.gov/resource/health-facility-general-information.json?$where=within_circle(longitude, 47.598177,-122.33448, 1000)