Women, Infants, and Children (WIC) Income Eligibility Guidelines API : 2013-2014

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 Women, Infants, and Children (WIC) Income Eligiblity Guidelines: 2013 - 2014 dataset. This data set includes income eligibility guidelines for participation in the Special Supplemental Nutrition Program for Women, Infants and Children (WIC). The Special Supplemental Nutrition Program for Women, Infants and Children (WIC) offers nutrition education, breastfeeding support, referrals and a variety of nutritious foods to low-income pregnant, breastfeeding or postpartum women, infants and children up to age five to promote and support good health. To be eligible to receive WIC benefits, one of the categorical requirements must be met, the residential requirement must be met, one of the income requirements must be met, and the nutritional requirement must be met. This data set is available at: https://health.data.ny.gov/Health/Women-Infants-and-Children-WIC-Income-Eligibility-/6zdy-fajb. For more information about the dataset, go to the dataset page 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 Women, Infants, and Children (WIC) Income Eligibility Guidelines API : 2013-2014 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/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.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/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.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/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.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/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?recall_id=94"

Fields

The following fields are available on the Women, Infants, and Children (WIC) Income Eligibility Guidelines API : 2013-2014 API.

household_size

Human Name: Household Size
Type: text
Number of people living in household

Examples

Retrieve all records with household_size equal to For each additional member, add::

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

https://health.data.ny.gov/resource/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?$where=within_circle(household_size, 47.598177,-122.33448, 1000)

annual

Human Name: Annual
Type: money
Maximum annual income for household size

Examples

Retrieve all records with annual equal to 167999:

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

https://health.data.ny.gov/resource/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?$where=within_circle(annual, 47.598177,-122.33448, 1000)

monthly

Human Name: Monthly
Type: money
Maximum monthly income for household size

Examples

Retrieve all records with monthly equal to 14008:

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

https://health.data.ny.gov/resource/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?$where=within_circle(monthly, 47.598177,-122.33448, 1000)

twice_monthly

Human Name: Twice-Monthly
Type: money
Maximum twice-monthly income for household size

Examples

Retrieve all records with twice_monthly equal to 7004:

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

https://health.data.ny.gov/resource/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?$where=within_circle(twice_monthly, 47.598177,-122.33448, 1000)

bi_weekly

Human Name: Bi-Weekly
Type: money
Maximum bi-weekly income for household size

Examples

Retrieve all records with bi_weekly equal to 6462:

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

https://health.data.ny.gov/resource/women-infants-and-children-wic-income-eligibility-guidelines-2013-2014.json?$where=within_circle(bi_weekly, 47.598177,-122.33448, 1000)

weekly

Human Name: Weekly
Type: money
Maximum weekly income for household size

Examples