Health Coalitions: A Resource for Community Collaboration

This dataset promotes community collaborations and increases partnerships with non-traditional, non-health focused partners. Users can explore where the Department of Health funded coalitions are located and the service areas they cover. A health coalition is defined as "a group involving multiple sectors of the community; coming together to identify community needs and solve community problems." The information is useful for program planning, as well as to develop targeted interventions. Additionally, the general public is able to identify projects within or near their communities. For more information please visit http://www.health.ny.gov/community/minority/, or go to the "About" tab. This data set is available at: https://health.data.ny.gov/Health/Health-Coalitions-A-Resource-for-Community-Collabo/w43m-6kfj

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 Coalitions: A Resource for Community Collaboration 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-coalitions-a-resource-for-community-collaboration.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-coalitions-a-resource-for-community-collaboration.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-coalitions-a-resource-for-community-collaboration.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-coalitions-a-resource-for-community-collaboration.json?recall_id=94"

Fields

The following fields are available on the Health Coalitions: A Resource for Community Collaboration API.

coalition_name

Human Name: Coalition Name
Type: text
The name of the collaborative group involving multiple sectors of the community; coming together to identify community needs and solve community problems.

Examples

Retrieve all records with coalition_name equal to Washington Heights Inwood Network, Best Asthma Care for Kids (WIN-BACK):
Retrieve all records with coalition_name equal to Washington Heights Inwood Network, Best Asthma Care for Kids (WIN-BACK):

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(coalition_name, 47.598177,-122.33448, 1000)

service_area_s

Human Name: Service Area(s)
Type: text
The county(ies) in which the coalition provides services or targets interventions.

Examples

Retrieve all records with service_area_s equal to Westchester:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(service_area_s, 47.598177,-122.33448, 1000)

contact

Human Name: Contact
Type: text
The member organization/entity identified through the survey to act as a point of contact

Examples

Retrieve all records with contact equal to YWCA of the City of New York:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(contact, 47.598177,-122.33448, 1000)

address

Human Name: Address
Type: text
The street address of the contact

Examples

Retrieve all records with address equal to Stony Brook University:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(address, 47.598177,-122.33448, 1000)

address_2

Human Name: Address 2
Type: text
continuation of the street address for the contact (i.e., suite number, PO Box)

Examples

Retrieve all records with address_2 equal to VC4-402:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(address_2, 47.598177,-122.33448, 1000)

city

Human Name: City
Type: text
The city where the contact is located

Examples

Retrieve all records with city equal to Woodside:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(city, 47.598177,-122.33448, 1000)

state

Human Name: State
Type: text
The state where the contact is located

Examples

zip_code

Human Name: Zip Code
Type: text
The zip code for the contact

Examples

Retrieve all records with zip_code equal to 14905:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(zip_code, 47.598177,-122.33448, 1000)

phone

Human Name: Phone
Type: text
A general phone number for the contact

Examples

Retrieve all records with phone equal to N/A:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(phone, 47.598177,-122.33448, 1000)

fax

Human Name: Fax
Type: text
The facsimile number for the contact

Examples

email

Human Name: Email
Type: email
A general email address for the contact

Examples

web_page

Human Name: Web Page
Type: url
webpage for the contact

Examples

Retrieve all records with web_page equal to url: https://www.camba.org/:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(web_page, 47.598177,-122.33448, 1000)

nysdoh_funding_program

Human Name: NYSDOH Funding Program
Type: text
The NYSDOH program providing funding for the initiative

Examples

Retrieve all records with nysdoh_funding_program equal to Tobacco Control Program:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(nysdoh_funding_program, 47.598177,-122.33448, 1000)

location_1

Human Name: Location 1
Type: location

Examples

Retrieve all records with location_1 equal to longitude: -73.14725999984898, latitude: 40.91642000018305, human_address: {"address":"Stony Brook University","city":"Stony Brook","state":"NY","zip":"11794"}:
Retrieve all records with location_1 equal to longitude: -73.14725999984898, latitude: 40.91642000018305, human_address: {"address":"Stony Brook University","city":"Stony Brook","state":"NY","zip":"11794"}:

Retrieve all records that occurred after 2012-08-10:

Retrieve all records with location_1 equal to longitude: -73.14725999984898, latitude: 40.91642000018305, human_address: {"address":"Stony Brook University","city":"Stony Brook","state":"NY","zip":"11794"}:

Retrieve all records that are greater than longitude: -74.92281250621329, latitude: 42.695864458494725, human_address: {"address":"1 Atwell Rd","city":"Cooperstown","state":"NY","zip":"13326"}:

Retrieve all records with location_1 equal to longitude: -73.14725999984898, latitude: 40.91642000018305, human_address: {"address":"Stony Brook University","city":"Stony Brook","state":"NY","zip":"11794"}:

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

https://health.data.ny.gov/resource/health-coalitions-a-resource-for-community-collaboration.json?$where=within_circle(location_1, 47.598177,-122.33448, 1000)