Catalog / EADA Athletics Data

EADA Athletics Data API

ope.ed.gov

Read-only access to public Equity in Athletics Disclosure Act data from the U.S. Department of Education. Search institutions, retrieve source-faithful report and comparison structures, query custom CSV data, list downloads, and access trend metadata. The site's detailed institution endpoint returns the latest available report; historical years are exposed through the site's custom-data CSV and downloadable files.

  • Sports
  • college athletics
  • EADA
  • higher education
  • education data
11 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 EADA Athletics 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.

Posts the website's institution search filter and returns its source identifiers, current survey year, location, enrollment, and pagination totals. State and other coded filters accept the codes returned by /v1/lookups. Page is zero-based, matching the upstream request field pageNumber.

Optional parameters 13

Institution-name search text.

City search text.

State codes from the source lookup.

Institution type codes from /v1/lookups.

Athletic classification codes from /v1/lookups.

Enrollment range codes from /v1/lookups.

Conference codes from /v1/lookups.

Use the source's international-institutions switch.

Source sort key.

Source sort direction.

Zero-based source page number.

Number of results requested from the source.

Source flag for requesting all results.

View call pricing
cURL · Institutions search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/f9f4cf94-1348-4bef-9743-9c05e171e157/v1/institutions/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETInstitutions by unit id report/v1/institutions/{unit_id}/report

Returns the website's full detailed institution response, including Header, Groups, Screens, Rows, Cells, source HTML labels and source Data objects. Pass UnitID from institution search Results. The observed detailed endpoint has no year parameter and returns the latest report available for that institution; use custom data for historical years.

Input

unit_idRequiredPath · integer

Source UnitID returned by institution search.

Example: 222178

Response

Groupsobject[]
Headerobject
IsCampusboolean
GETLookups/v1/lookups

Returns source-coded values used by institution search, including states, types, classifications, conferences, and enrollment ranges, plus reporting years and year-keyed custom-data categories. Pass one or more years to retrieve the source category and qualifier set for each year.

Input

yearsOptionalQuery · array | null

Custom-data years whose source categories and qualifiers should be returned; defaults to 2024.

Example: 2024

Response

statesobject[]
states[].Code?string | integer | null
states[].Data?unknown | null
states[].Description?string | null
conferencesobject[]
conferences[].Code?string | integer | null
conferences[].Data?unknown | null
conferences[].Description?string | null
classificationsobject[]
classifications[].Code?string | integer | null
classifications[].Data?unknown | null
classifications[].Description?string | null
reporting_yearsinteger[]
enrollment_rangesobject[]
enrollment_ranges[].Code?string | integer | null
enrollment_ranges[].Data?unknown | null
enrollment_ranges[].Description?string | null
institution_typesobject[]
institution_types[].Code?string | integer | null
institution_types[].Data?unknown | null
institution_types[].Description?string | null
custom_data_categoriesobject

Fields marked ? are optional.

GETCompare/v1/compare

Returns the source comparison structure for one to four UnitIDs, including source Institutions and ScreenGroups. numberFormat is the source's observed absolute/percent presentation selector.

Input

unit_idsRequiredQuery · array

One to four source UnitIDs from search Results.

Example: 222178

numberFormatOptionalQuery · string, default: absolute

Source comparison number format.

Example: absolute

Response

Institutionsobject[]
ScreenGroupsobject[]
GETCustom data/v1/custom-data

Uses the website's customData/files selection operation. Years, categories, and UnitIDs are source values; returned CSV headers and cell strings are preserved as records without numeric reformatting.

Input

yearsRequiredQuery · array

One or more source reporting years.

Example: 2024

categoriesRequiredQuery · array

Custom-data DownloadID values from lookups.custom_data_categories.

Example: 1

unit_idsRequiredQuery · array

Selected source UnitIDs.

Example: 222178

Response

Yearsinteger[]
Headersstring[]
Recordsobject[]
Categoriesinteger[]
RecordCountinteger
SourceFormat?string, default: CSV

Fields marked ? are optional.

GETCustom data filter/v1/custom-data/filter

Uses the website's customData/filesByFilter read operation. Search filter names and coded arrays are passed using the same source property names as institution search; years, categories, and qualifiers are source custom-data selections.

Input

yearsRequiredQuery · array

One or more source reporting years.

Example: 2024

categoriesRequiredQuery · array

Custom-data DownloadID values.

Example: 1

qualifiersOptionalQuery · array | null

Source qualifier values for category selections.

Example: 1

nameOptionalQuery · string | null

Institution-name filter text.

Example: Abilene

cityOptionalQuery · string | null

City filter text.

Example: Abilene

stateOptionalQuery · array | null

Source state codes.

Example: TX

institutionTypeOptionalQuery · array | null

Source institution type codes.

Example: 1

classificationOptionalQuery · array | null

Source classification codes.

Example: 1

enrollmentRangeOptionalQuery · array | null

Source enrollment range codes.

Example: 5

conferenceOptionalQuery · array | null

Source conference codes.

Example: 101

onlyInternationalOptionalQuery · boolean, default: false

Source international switch.

Example: false

Response

Yearsinteger[]
Headersstring[]
Recordsobject[]
Categoriesinteger[]
RecordCountinteger
SourceFormat?string, default: CSV

Fields marked ? are optional.

GETData files/v1/data-files

Lists every file entry returned by the website, its year, format, description, and source download URL.

Input

No input parameters.

Response

Filesobject[]
Files[].Yearinteger
Files[].Formatstring
Files[].FileNamestring
Files[].LinkNamestring
Files[].Description?string | null
Files[].DownloadURLstring
Yearsinteger[]
FileTypesstring[]

Fields marked ? are optional.

GETTrend subjects/v1/trend/subjects

Returns the site's trend subjects and nested question identifiers from its separate trend API.

Input

No input parameters.

Response

Subjectsobject[]
GETTrend questions by question id/v1/trend/questions/{question_id}

Returns the source trend question payload for a question ID discovered from trend subjects.

Input

question_idRequiredPath · integer

Trend question ID from /v1/trend/subjects.

Example: 201

Response

Dataunknown
GETTrend questions by question id years/v1/trend/questions/{question_id}/years

Returns source year options for a trend question.

Input

question_idRequiredPath · integer

Trend question ID from /v1/trend/subjects.

Example: 201

Response

Dataunknown
GETTrend questions by question id variables/v1/trend/questions/{question_id}/variables

Returns source variables and filter dimensions for a trend question.

Input

question_idRequiredPath · integer

Trend question ID from /v1/trend/subjects.

Example: 201

Response

Dataunknown

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.