Notre Dame Fighting Irish Athletics API
Live, read-only access to fightingirish.com's structured public athletics records. Sports, staff, departments, rosters, players, schedules, news articles and source pagination are returned with the site's identifiers, labels, values and URLs unchanged. The source publishes staff and player biographies as JSON fields; this API does not parse HTML. The source has no standalone document/PDF listing endpoint and the sampled linked PDF URL returned an HTML response rather than PDF bytes over the permitted HTTP transport; /v1/documents returns structured links attached to live schedule-event records and is not an exhaustive document catalog or PDF extractor.
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 Notre Dame Fighting Irish Athletics 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/0686b5f0-2ae5-4c13-a978-aca56e452134/v1/sports' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETSports/v1/sports
List sports
Input
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSports by identifier/v1/sports/{identifier}
Read a sport
Input
identifierRequiredPath · stringSource sport id or slug.
Example: 8
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nulldata.gender?string | nulldata.schedule_id?integer | nulldata.abbreviation?string | nulldata.default_roster_id?integer | nulldata.default_season_id?integer | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETDepartments/v1/departments
List staff departments
Input
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
with_staffOptionalQuery · boolean, default: trueUse the source's populated staff-directory department associations.
Example: true
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETStaff/v1/staff
List athletics staff
Input
department_idOptionalQuery · integer | nullSource department id from /v1/departments.
Example: 45
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETStaff by identifier/v1/staff/{identifier}
Read a staff profile
Input
identifierRequiredPath · stringSource staff id or slug.
Example: 100
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nulldata.email?string | nulldata.phone?string | nulldata.title?string | nulldata.biography?string | nulldata.full_name?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETRosters/v1/rosters
List rosters and available seasons
Input
sport_idOptionalQuery · integer | nullSource sport id from /v1/sports.
Example: 8
season_idOptionalQuery · integer | nullSource season id.
Example: 123
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETRosters by identifier/v1/rosters/{identifier}
Read a roster metadata record
Input
identifierRequiredPath · stringSource roster id.
Example: 15
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.sport?object | nulldata.pdf_id?string | nulldata.season?object | nulldata.sport_id?integer | nulldata.season_id?integer | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSeasons/v1/seasons
List source seasons
Input
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSeasons by identifier/v1/seasons/{identifier}
Read a season
Input
identifierRequiredPath · stringSource season id or slug.
Example: 156
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSeasons by slug by slug/v1/seasons/by/slug/{slug}
Read a season by source slug
Input
slugRequiredPath · stringSource season slug.
Example: 2026-27
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETPlayers/v1/players
List roster players
Input
roster_idOptionalQuery · integer | nullSource roster id from /v1/rosters.
Example: 15
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETPlayer rosters/v1/player-rosters
List season-specific player roster memberships
Input
roster_idOptionalQuery · integer | nullSource roster id.
Example: 480
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 20Source records per page.
Example: 20
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETPlayers by identifier/v1/players/{identifier}
Read a player profile
Input
identifierRequiredPath · stringSource player id or slug.
Example: 1
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nulldata.hometown?string | nulldata.full_name?string | nulldata.high_school?string | nulldata.previous_school?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETPlayers by slug by slug/v1/players/by/slug/{slug}
Read a player profile by source slug
Input
slugRequiredPath · stringSource player slug.
Example: mark-zackery-iv-2
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nulldata.hometown?string | nulldata.full_name?string | nulldata.high_school?string | nulldata.previous_school?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETRoster staff members/v1/roster-staff-members
List season-specific coaches and support staff
Input
roster_idOptionalQuery · integer | nullSource roster id.
Example: 480
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 20Source records per page.
Example: 20
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETRoster staff members by identifier/v1/roster-staff-members/{identifier}
Read a roster staff membership
Input
identifierRequiredPath · stringSource roster-staff-members id.
Example: 1
Response
dataobjectdata.id?integer | nulldata.type?string | nulldata.position?string | nulldata.roster_id?integer | nulldata.staff_member?object | nulldata.staff_member_id?integer | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETStaff by slug by slug/v1/staff/by/slug/{slug}
Read a staff profile by source slug
Input
slugRequiredPath · stringSource staff slug.
Example: tristan-musser
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.slug?string | nulldata.email?string | nulldata.phone?string | nulldata.title?string | nulldata.biography?string | nulldata.full_name?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSchedules/v1/schedules
List schedules by sport and season
Input
sport_idOptionalQuery · integer | nullSource sport id from /v1/sports.
Example: 8
season_idOptionalQuery · integer | nullSource season id.
Example: 123
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSchedule events/v1/schedule-events
List schedule events and results
Input
schedule_idOptionalQuery · integer | nullSource schedule id.
Example: 730
pastOptionalQuery · boolean | nullSource past-event filter.
Example: true
upcomingOptionalQuery · boolean | nullSource upcoming-event filter.
Example: false
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 20Source records per page.
Example: 20
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSchedule events by identifier/v1/schedule-events/{identifier}
Read a schedule event
Input
identifierRequiredPath · stringSource schedule event id.
Example: 20525
Response
dataobjectdata.id?integer | nulldata.venue?string | nulldata.datetime?string | nulldata.venue_type?string | nulldata.schedule_id?integer | nulldata.is_conference?boolean | nulldata.opponent_name?string | nulldata.schedule_event_links?object[]data.schedule_event_result?object | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETDocuments/v1/documents
Enumerate live structured link references in a selected source scope. fightingirish.com has no standalone documents JSON collection. This route follows every event page for each selected schedule, preserves all links, labels PDF-like links as ``document`` and other broadcasts/tickets/radio links as ``related_link``, and carries schedule, sport, season, roster, article and event parent identity. Use schedule_id, sport_id/season_id, or successive schedule pages to cover the source's published schedules; no PDF is fetched or parsed here.
Input
schedule_idOptionalQuery · integer | nullLimit enumeration to one source schedule.
Example: 730
schedule_event_idOptionalQuery · integer | nullRead links for one source schedule event instead.
Example: 20525
sport_idOptionalQuery · integer | nullEnumerate schedules for this source sport.
Example: 8
season_idOptionalQuery · integer | nullEnumerate schedules for this source season.
Example: 156
roster_idOptionalQuery · integer | nullAdd the linked PDF/reference on one roster.
Example: 480
article_idOptionalQuery · integer | nullAdd structured links on one article.
Example: 77270
pageOptionalQuery · integer, default: 1Schedule page when schedule_id is omitted; use subsequent pages for full coverage.
Example: 1
per_pageOptionalQuery · integer, default: 20Schedules per source page when schedule_id is omitted.
Example: 20
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSchedules by identifier/v1/schedules/{identifier}
Read a schedule record
Input
identifierRequiredPath · stringSource schedule id.
Example: 730
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.sport?object | nulldata.events?object[]data.season?object | nulldata.sport_id?integer | nulldata.season_id?integer | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETSchedules by identifier statistics/v1/schedules/{identifier}/statistics
Read schedule statistics
Input
identifierRequiredPath · stringSource schedule id.
Example: 730
Response
dataobjectdata.id?integer | nulldata.name?string | nulldata.sport?object | nulldata.events?object[]data.season?object | nulldata.sport_id?integer | nulldata.season_id?integer | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETArticles/v1/articles
List news articles
Input
queryOptionalQuery · string | nullSource article search text, when supported.
Example: contract
sport_idOptionalQuery · integer | nullSource sport id filter.
Example: 8
category_idOptionalQuery · integer | nullSource category id filter.
Example: 1
typeOptionalQuery · string | nullSource article type, such as video.
Example: video
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 20Source records per page.
Example: 20
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETArticles by identifier/v1/articles/{identifier}
Read a full article
Input
identifierRequiredPath · stringSource article id or slug.
Example: 77270
Response
dataobjectdata.id?integer | nulldata.slug?string | nulldata.type?string | nulldata.title?string | nulldata.author_id?integer | nulldata.permalink?string | nulldata.published_at?string | nulldata.author_byline?string | nulldata.contentBlocks?object[]data.orderedSports?object[]data.short_description?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETArticles by slug by slug/v1/articles/by/slug/{slug}
Read an article by source slug
Input
slugRequiredPath · stringSource article slug.
Example: the-42nd-degree-the-irish-head-west
Response
dataobjectdata.id?integer | nulldata.slug?string | nulldata.type?string | nulldata.title?string | nulldata.author_id?integer | nulldata.permalink?string | nulldata.published_at?string | nulldata.author_byline?string | nulldata.contentBlocks?object[]data.orderedSports?object[]data.short_description?string | nullmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETArticle years/v1/article-years
List article years
Input
pageOptionalQuery · integer, default: 1Source page number.
Example: 1
per_pageOptionalQuery · integer, default: 100Source records per page.
Example: 100
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
GETArticle ranking/v1/article-ranking
List source article rankings
Input
limitOptionalQuery · integer, default: 4Source ranking result limit.
Example: 4
Response
dataarray | objectmeta?objectmeta.to?integer | nullmeta.from?integer | nullmeta.total?integer | nullmeta.per_page?integer | nullmeta.last_page?integer | nullmeta.current_page?integer | nulllinks?objectlinks.last?string | nulllinks.next?string | nulllinks.prev?string | nulllinks.first?string | nullFields marked ? are optional.
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.
An account is required to submit an extension. Prepare your request, then sign in to build.