Catalog / IPEDS Structured Data

IPEDS Structured Data API

nces.ed.gov

Live, read-only access to structured IPEDS downloadable data from the U.S. Department of Education's National Center for Education Statistics. Use UNITID from institution search to retrieve year-specific survey files, compare schools, and obtain current download and dictionary URLs. Values and field names remain the source strings. Institution Profile and comparison subject JSON are returned in their source structures. College Navigator's HTML-only team-level athletics filter is not fabricated; the API exposes the corresponding ATHURL directory link.

  • Research
  • IPEDS
  • higher education
  • institutions
  • college athletics
  • education data
6 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the IPEDS Structured Data API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Institutions Search

Optional parameters 9

Case-insensitive substring of the source INSTNM field.

IPEDS STABBR or a full U.S. state name.

ZIP prefix matched against the source ZIP field.

JSON object of exact raw HD column/value filters, for example {"CONTROL":"1"}.

Bulk-file approximation: require or exclude a nonblank source ATHURL; this is not a team-level filter.

Raw HD column used for ascending sort; INSTNM is the default.

One-based result page after filtering.

Number of source records returned per page.

IPEDS directory data year.

View call pricing
cURL · Institutions search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/498f1a9d-88e9-4181-b44b-c83086f54fcf/v1/institutions/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETInstitutions by unitid/v1/institutions/{unitid}

Institution Detail

Input

unitidRequiredPath · string

IPEDS UNITID returned by institution search.

Example: 198419

yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023

IPEDS data year used for every selected component.

Example: 2023

componentsOptionalQuery · string | null

Comma-separated component codes such as HD,EF,ADM,GR,IC,OM,FLAGS; exact stems such as EF2023B are also accepted.

Example: HD,EF,ADM,GR,IC,OM,FLAGS

Response

notes?string[]
unitidstring
data_yearinteger
componentsobject
profile_urlstring
source_urlsstring[]
profile_subjects?object

Fields marked ? are optional.

GETInstitution profile by unitid/v1/institution-profile/{unitid}

Institution Profile

Input

unitidRequiredPath · string

IPEDS UNITID in the official Institution Profile URL.

Example: 198419

yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023

IPEDS data year for the structured profile substitute.

Example: 2023

componentsOptionalQuery · string | null

Comma-separated IPEDS component codes to include in the structured response.

Example: HD,EF,GR,IC

Response

notes?string[]
unitidstring
data_yearinteger
componentsobject
profile_urlstring
source_urlsstring[]
profile_subjects?object

Fields marked ? are optional.

GETCompare/v1/compare

Institutions Compare

Input

unitidsRequiredQuery · string

Comma-separated UNITIDs, normally copied from institution search.

Example: 198419,199120

yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023

IPEDS data year used for each institution.

Example: 2023

componentsOptionalQuery · string | null

Comma-separated component codes or exact file stems to compare.

Example: HD,EF,GR,IC

Response

notes?string[]
unitidsstring[]
data_yearinteger
institutionsobject[]
institutions[].unitidstring
institutions[].componentsobject
source_subjects?object

Fields marked ? are optional.

GETData files/v1/data-files

Data Files

Input

yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023

IPEDS data year in the source archive naming scheme.

Example: 2023

componentOptionalQuery · string, default: ALL

IPEDS component code, exact file stem such as EF2023B, or ALL for the live supported-family index.

Example: ALL

Response

filesobject[]
files[].titlestring
files[].availableboolean
files[].data_yearinteger
files[].file_codestring
files[].descriptionstring
files[].http_statusinteger | null
files[].download_urlstring
files[].dictionary_urlstring
files[].source_listing_urlstring
files[].dictionary_availableboolean
files[].dictionary_http_statusinteger | null
notes?string[]
componentstring
data_yearinteger

Fields marked ? are optional.

GETData years/v1/data-years

Data Years

Input

start_yearOptionalQuery · integer, min: 1980, max: 2100, default: 2022

First data year to check, inclusive.

Example: 2022

end_yearOptionalQuery · integer, min: 1980, max: 2100, default: 2024

Last data year to check, inclusive.

Example: 2024

componentOptionalQuery · string, default: ALL

Component family to check, or ALL for the supported-family availability map.

Example: ALL

Response

years_checkedinteger[]
available_yearsinteger[]
components_checkedstring[]
source_listing_urlstring
availability_by_yearobject

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.