IPEDS Structured Data API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 search/v1/institutions/search
Institutions Search
Input
nameOptionalQuery · string | nullCase-insensitive substring of the source INSTNM field.
Example: Duke
stateOptionalQuery · string | nullIPEDS STABBR or a full U.S. state name.
Example: NC
zip_codeOptionalQuery · string | nullZIP prefix matched against the source ZIP field.
Example: 27708
filtersOptionalQuery · string | nullJSON object of exact raw HD column/value filters, for example {"CONTROL":"1"}.
Example: {"CONTROL":"1"}
athleticsOptionalQuery · boolean | nullBulk-file approximation: require or exclude a nonblank source ATHURL; this is not a team-level filter.
Example: true
sortOptionalQuery · string, default: INSTNMRaw HD column used for ascending sort; INSTNM is the default.
Example: INSTNM
pageOptionalQuery · integer, min: 1, default: 1One-based result page after filtering.
Example: 1
per_pageOptionalQuery · integer, min: 1, max: 100, default: 25Number of source records returned per page.
Example: 25
yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023IPEDS directory data year.
Example: 2023
Response
pageintegerrecordsobject[]per_pageintegerdata_yearintegernext_pageinteger | nullsource_urlstringtotal_countintegerfilter_interpretationobjectGETInstitutions by unitid/v1/institutions/{unitid}
Institution Detail
Input
unitidRequiredPath · stringIPEDS UNITID returned by institution search.
Example: 198419
yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023IPEDS data year used for every selected component.
Example: 2023
componentsOptionalQuery · string | nullComma-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[]unitidstringdata_yearintegercomponentsobjectprofile_urlstringsource_urlsstring[]profile_subjects?objectFields marked ? are optional.
GETInstitution profile by unitid/v1/institution-profile/{unitid}
Institution Profile
Input
unitidRequiredPath · stringIPEDS UNITID in the official Institution Profile URL.
Example: 198419
yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023IPEDS data year for the structured profile substitute.
Example: 2023
componentsOptionalQuery · string | nullComma-separated IPEDS component codes to include in the structured response.
Example: HD,EF,GR,IC
Response
notes?string[]unitidstringdata_yearintegercomponentsobjectprofile_urlstringsource_urlsstring[]profile_subjects?objectFields marked ? are optional.
GETCompare/v1/compare
Institutions Compare
Input
unitidsRequiredQuery · stringComma-separated UNITIDs, normally copied from institution search.
Example: 198419,199120
yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023IPEDS data year used for each institution.
Example: 2023
componentsOptionalQuery · string | nullComma-separated component codes or exact file stems to compare.
Example: HD,EF,GR,IC
Response
notes?string[]unitidsstring[]data_yearintegerinstitutionsobject[]institutions[].unitidstringinstitutions[].componentsobjectsource_subjects?objectFields marked ? are optional.
GETData files/v1/data-files
Data Files
Input
yearOptionalQuery · integer, min: 1980, max: 2100, default: 2023IPEDS data year in the source archive naming scheme.
Example: 2023
componentOptionalQuery · string, default: ALLIPEDS component code, exact file stem such as EF2023B, or ALL for the live supported-family index.
Example: ALL
Response
filesobject[]files[].titlestringfiles[].availablebooleanfiles[].data_yearintegerfiles[].file_codestringfiles[].descriptionstringfiles[].http_statusinteger | nullfiles[].download_urlstringfiles[].dictionary_urlstringfiles[].source_listing_urlstringfiles[].dictionary_availablebooleanfiles[].dictionary_http_statusinteger | nullnotes?string[]componentstringdata_yearintegerFields marked ? are optional.
GETData years/v1/data-years
Data Years
Input
start_yearOptionalQuery · integer, min: 1980, max: 2100, default: 2022First data year to check, inclusive.
Example: 2022
end_yearOptionalQuery · integer, min: 1980, max: 2100, default: 2024Last data year to check, inclusive.
Example: 2024
componentOptionalQuery · string, default: ALLComponent family to check, or ALL for the supported-family availability map.
Example: ALL
Response
years_checkedinteger[]available_yearsinteger[]components_checkedstring[]source_listing_urlstringavailability_by_yearobjectDon’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.
An account is required to submit an extension. Prepare your request, then sign in to build.