National Center for Education Statistics (NCES) - Integrated Postsecondary Education Data System (IPEDS) - Awards/degrees Conferred by Program - 2011 - API

The total number of awards by type of program and level of award (certificate or degree). Type of program is categorized according to the Classification of Instructional Programs (CIP), a detailed coding system for postsecondary instructional programs. Data covers all awards granted between July 1, 2010 and June 30, 2011. This file contains multiple records per institution. Each record is uniquely defined by the variables IPEDS ID (UNITID), classification of instructional program (CIPCODE) and award level (AWLEVEL). Data shown are for first majors only.

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 National Center for Education Statistics (NCES) - Integrated Postsecondary Education Data System (IPEDS) - Awards/degrees Conferred by Program - 2011 - 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://explore.data.gov/resource/nces-ipeds-c2011_a.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://explore.data.gov/resource/nces-ipeds-c2011_a.json?recall_id=94', headers={'X-App-Token': sys.argv[1]})
print r.status_code
print r.text
request = require 'request'
options = uri: 'https://explore.data.gov/resource/nces-ipeds-c2011_a.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://explore.data.gov/resource/nces-ipeds-c2011_a.json?recall_id=94"

Fields

The following fields are available on the National Center for Education Statistics (NCES) - Integrated Postsecondary Education Data System (IPEDS) - Awards/degrees Conferred by Program - 2011 - API API.

unitid

Human Name: UNITID
Type: number
Unique identification number of the institution

Examples

Retrieve all records with unitid equal to 480569:
Retrieve all records with unitid equal to 480569:

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

Retrieve all records with unitid equal to 480569:

Retrieve all records that are greater than 100654:

Retrieve all records with unitid equal to 480569:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(unitid, 47.598177,-122.33448, 1000)

cipcode

Human Name: CIPCODE
Type: text
CIP Code - 2010 Classification

Examples

Retrieve all records with cipcode equal to 99:
Retrieve all records with cipcode equal to 99:

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

Retrieve all records with cipcode equal to 99:

Retrieve all records that are greater than 01:

Retrieve all records with cipcode equal to 99:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(cipcode, 47.598177,-122.33448, 1000)

program_title

Human Name: PROGRAM_TITLE
Type: text

Examples

Retrieve all records with program_title equal to Zoology/Animal Biology, Other:
Retrieve all records with program_title equal to Zoology/Animal Biology, Other:

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

Retrieve all records with program_title equal to Zoology/Animal Biology, Other:

Retrieve all records that are greater than Accounting:

Retrieve all records with program_title equal to Zoology/Animal Biology, Other:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(program_title, 47.598177,-122.33448, 1000)

completions_total

Human Name: COMPLETIONS_TOTAL
Type: number

Examples

Retrieve all records with completions_total equal to 92011:
Retrieve all records with completions_total equal to 92011:

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

Retrieve all records with completions_total equal to 92011:

Retrieve all records that are greater than 0:

Retrieve all records with completions_total equal to 92011:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(completions_total, 47.598177,-122.33448, 1000)

distance_ed_program

Human Name: DISTANCE_ED_PROGRAM
Type: text

Examples

Retrieve all records with distance_ed_program equal to Yes:
Retrieve all records with distance_ed_program equal to Yes:

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

Retrieve all records with distance_ed_program equal to Yes:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(distance_ed_program, 47.598177,-122.33448, 1000)

award_level

Human Name: AWARD_LEVEL
Type: text

Examples

Retrieve all records with award_level equal to Post-master's certificate:
Retrieve all records with award_level equal to Post-master's certificate:

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

Retrieve all records with award_level equal to Post-master's certificate:

Retrieve all records that are greater than Associate's degree:

Retrieve all records with award_level equal to Post-master's certificate:

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

https://explore.data.gov/resource/nces-ipeds-c2011_a.json?$where=within_circle(award_level, 47.598177,-122.33448, 1000)