NCAA API

https://ncaa-api.henrygd.me
Admin
NCAA API provides consumable data from ncaa.com including scoreboards, game information, statistics,...
Tokens:3,854
Snippets:36
Trust Score:7.6
Update:10 months ago
Show doc for...
Tokens:
Raw
### GET /schedule-alt/{sport}/{division}/{year}

Source: https://ncaa-api.henrygd.me/index

Retrieves game dates for a given sport, division, and year.

```APIDOC
## GET /schedule-alt/{sport}/{division}/{year}

### Description
Retrieves game dates for a given sport and division and year.

### Method
GET

### Endpoint
/schedule-alt/{sport}/{division}/{year}

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport identifier.
- **division** (string) - Required - The division identifier.
- **year** (string) - Required - The year for which to retrieve schedules.

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/schedule-alt/{sport}/{division}/{year}'
```
```

--------------------------------

### GET /schools-index

Source: https://ncaa-api.henrygd.me/index

Returns a list of all NCAA schools, including their slug, name, and long name.

```APIDOC
## GET /schools-index

### Description
Returns a list of all schools with slug, name, and long name.

### Method
GET

### Endpoint
/schools-index

### Request Example
```shell
curl https://ncaa-api.henrygd.me/schools-index
```
```

--------------------------------

### GET /scoreboard/{sport}/{path}

Source: https://ncaa-api.henrygd.me/index

Fetches scoreboard data for a given sport and path.

```APIDOC
## GET /scoreboard/{sport}/{path}

### Description
Fetches scoreboard data for a given sport and path.

### Method
GET

### Endpoint
/scoreboard/{sport}/{path}

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport identifier.
- **path** (string) - Required - The path parameter for the scoreboard query.

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/scoreboard/{sport}/{path}'
```
```

--------------------------------

### Get School Logo

Source: https://ncaa-api.henrygd.me/index

Fetches the logo for a specific NCAA school. Requires the school's 'slug' or 'team_seo' as a path parameter. An optional 'dark' query parameter (boolean) can be used to get a logo suitable for dark backgrounds.

```Shell
curl 'https://ncaa-api.henrygd.me/logo/{school}.svg?dark=true'
```

--------------------------------

### Get Game Schedule

Source: https://ncaa-api.henrygd.me/index

Fetches game dates for a given sport and division. The 'path' parameter can be a year (YYYY) for football or a year and month (YYYY/MM) for most other sports.

```Shell
curl 'https://ncaa-api.henrygd.me/schedule/{sport}/{division}/{path}'
```

--------------------------------

### Get Schools Index

Source: https://ncaa-api.henrygd.me/index

Retrieves a list of all NCAA schools, including their slug, name, and long name. This endpoint does not require any path or query parameters.

```Shell
curl https://ncaa-api.henrygd.me/schools-index
```

--------------------------------

### GET /news/{sport}/{division}

Source: https://ncaa-api.henrygd.me/index

Fetches news articles and videos for a specific sport and division, returning parsed RSS feed data.

```APIDOC
## GET /news/{sport}/{division}

### Description
Fetches news articles and videos for a given sport and division. Returns parsed RSS feed data in JSON format.

### Method
GET

### Endpoint
/news/{sport}/{division}

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport identifier (e.g., "basketball-men", "football").
- **division** (string) - Required - The division identifier (e.g., "d1", "fbs").

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/news/{sport}/{division}'
```
```

--------------------------------

### Get Rankings Data

Source: https://ncaa-api.henrygd.me/index

Fetches rankings for a given sport and division. The 'path' parameter is a string that specifies the sport, division, and ranking source (e.g., 'football/fbs/associated-press').

```Shell
curl 'https://ncaa-api.henrygd.me/rankings/{path}'
```

--------------------------------

### Game Information API

Source: https://ncaa-api.henrygd.me/index

Get general information about a specific game using its ID.

```APIDOC
## GET /game/{id}

### Description
Retrieves general information about a specific game.

### Method
GET

### Endpoint
`/game/{id}`

### Parameters
#### Path Parameters
- **id** (number) - Required - The unique identifier for the game.

### Request Example
```shell
curl https://ncaa-api.henrygd.me/game/1
```

### Response
#### Success Response (200)
- **gameInfo** (object) - Contains detailed information about the game.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Stats API

Source: https://ncaa-api.henrygd.me/index

Get statistics for a given sport, division, year, and path.

```APIDOC
## GET /stats/{sport}/{division}/{year}/{path}

### Description
Retrieves statistics for a specified sport, division, year, and path.

### Method
GET

### Endpoint
`/stats/{sport}/{division}/{year}/{path}`

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport for which to retrieve stats (e.g., football, basketball-men).
- **division** (string) - Required - The division of the sport (e.g., fbs, d1).
- **year** (string) - Required - The year for the stats (e.g., current, 2024).
- **path** (string) - Required - The specific path for the stats (e.g., individual/20, team/28).

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/stats/{sport}/{division}/{year}/{path}'
```

### Response
#### Success Response (200)
- **stats** (object) - Contains the requested statistics.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### GET /rankings/{path}

Source: https://ncaa-api.henrygd.me/index

Retrieves rankings for a given sport. The path parameter specifies the sport, division, and ranking source.

```APIDOC
## GET /rankings/{path}

### Description
Retrieves rankings for a given sport.

### Method
GET

### Endpoint
/rankings/{path}

### Parameters
#### Path Parameters
- **path** (string) - Required - Specifies the sport, division, and ranking source (e.g., "football/fbs/associated-press", "basketball-women/d1/associated-press").

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/rankings/{path}'
```
```

--------------------------------

### GET /logo/{school}.svg

Source: https://ncaa-api.henrygd.me/index

Retrieves the logo for an NCAA school. You can specify a dark mode version.

```APIDOC
## GET /logo/{school}.svg

### Description
Retrieves logos for NCAA schools. Use the school `slug` or `team_seo` property.

### Method
GET

### Endpoint
/logo/{school}.svg

### Parameters
#### Path Parameters
- **school** (string) - Required - The school identifier (slug or team_seo).

#### Query Parameters
- **dark** (boolean) - Optional - Set to `true` to get a version of the logo that works better on dark backgrounds.

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/logo/{school}.svg?dark=true'
```
```

--------------------------------

### Get Championship History

Source: https://ncaa-api.henrygd.me/index

Retrieves the championship history for a specified sport. Requires a 'path' parameter which is a string representing the sport and division (e.g., 'bowling/nc').

```Shell
curl 'https://ncaa-api.henrygd.me/history/{path}'
```

--------------------------------

### Get Game Schedule (Alternative)

Source: https://ncaa-api.henrygd.me/index

Retrieves game dates for a given sport, division, and year. This endpoint is an alternative to the main schedule endpoint and specifically uses a 'year' path parameter.

```Shell
curl 'https://ncaa-api.henrygd.me/schedule-alt/{sport}/{division}/{year}'
```

--------------------------------

### Get Game Play-by-Play - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Fetches the play-by-play data for a specific NCAA game. Requires the game 'id' as a path parameter. Data availability may be limited for certain seasons.

```shell
curl https://ncaa-api.henrygd.me/game/{id}/play-by-play
```

--------------------------------

### Get Standings Data - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Fetches team standings for a specified sport and path. The 'path' parameter can include division information. Requires 'sport' and 'path' as parameters.

```shell
curl 'https://ncaa-api.henrygd.me/standings/{sport}/{path}'
```

--------------------------------

### GET /history/{path}

Source: https://ncaa-api.henrygd.me/index

Retrieves championship history for a given sport. The path parameter specifies the sport and division.

```APIDOC
## GET /history/{path}

### Description
Retrieves championship history for a given sport.

### Method
GET

### Endpoint
/history/{path}

### Parameters
#### Path Parameters
- **path** (string) - Required - Specifies the sport and division (e.g., "bowling/nc", "basketball-women/d1").

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/history/{path}'
```
```

--------------------------------

### Get News Feed

Source: https://ncaa-api.henrygd.me/index

Retrieves news articles and videos for a specific sport and division. Returns parsed RSS feed data in JSON format. Requires 'sport' and 'division' path parameters.

```Shell
curl 'https://ncaa-api.henrygd.me/news/{sport}/{division}'
```

--------------------------------

### GET /schedule/{sport}/{division}/{path}

Source: https://ncaa-api.henrygd.me/index

Retrieves game dates for a given sport and division. The path parameter specifies the date range (YYYY/MM or YYYY for football).

```APIDOC
## GET /schedule/{sport}/{division}/{path}

### Description
Retrieves game dates for a given sport and division. Most sports use `YYYY/MM`, but football uses `YYYY`.

### Method
GET

### Endpoint
/schedule/{sport}/{division}/{path}

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport identifier.
- **division** (string) - Required - The division identifier.
- **path** (string) - Required - The date path, typically `YYYY/MM` or `YYYY` for football.

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/schedule/{sport}/{division}/{path}'
```
```

--------------------------------

### Get Scoreboard Data - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Retrieves scoreboard data for a specified sport and path. The date format varies by sport (YYYY/MM/DD or YYYY/WK). Omitting the date fetches today's or the previous game's scores. Requires 'sport' and 'path' as parameters.

```shell
curl 'https://ncaa-api.henrygd.me/scoreboard/{sport}/{path}'
```

--------------------------------

### Get Game Information - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Fetches general information about a specific NCAA game using its unique ID. Requires the 'id' of the game as a path parameter. Note: Data availability may vary for some seasons due to upstream changes.

```shell
curl https://ncaa-api.henrygd.me/game/{id}
```

--------------------------------

### Get Game Boxscore - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Retrieves the boxscore for a specific NCAA game. Requires the game 'id' as a path parameter. Data availability may be limited for certain seasons.

```shell
curl https://ncaa-api.henrygd.me/game/{id}/boxscore
```

--------------------------------

### Get Game Scoring Summary - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Retrieves the scoring summary for a specific NCAA game. Requires the game 'id' as a path parameter. Data availability may be limited for certain seasons.

```shell
curl https://ncaa-api.henrygd.me/game/{id}/scoring-summary
```

--------------------------------

### Get Game Team Stats - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Fetches the team statistics for a specific NCAA game. Requires the game 'id' as a path parameter. Data availability may be limited for certain seasons.

```shell
curl https://ncaa-api.henrygd.me/game/{id}/team-stats
```

--------------------------------

### Get Stats Data - Shell Curl

Source: https://ncaa-api.henrygd.me/index

Retrieves statistical data for a given sport, division, year, and path. Requires 'sport', 'division', 'year', and 'path' as parameters. The 'path' parameter specifies the type of stats (e.g., individual, team).

```shell
curl 'https://ncaa-api.henrygd.me/stats/{sport}/{division}/{year}/{path}'
```

--------------------------------

### Standings API

Source: https://ncaa-api.henrygd.me/index

Retrieve standings for a given sport and division path.

```APIDOC
## GET /standings/{sport}/{path}

### Description
Retrieves standings for a specified sport and division path.

### Method
GET

### Endpoint
`/standings/{sport}/{path}`

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport for which to retrieve standings (e.g., football, basketball-women).
- **path** (string) - Required - The specific path for the sport and division (e.g., fbs, fbs/big-ten, d1/asun).

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/standings/{sport}/{path}'
```

### Response
#### Success Response (200)
- **standings** (object) - Contains the requested standings data.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Game Play by Play API

Source: https://ncaa-api.henrygd.me/index

Retrieve the play-by-play details for a specific game. Note: Some seasons may not return data due to upstream changes.

```APIDOC
## GET /game/{id}/play-by-play

### Description
Retrieves the play-by-play information for a specific game.

### Method
GET

### Endpoint
`/game/{id}/play-by-play`

### Parameters
#### Path Parameters
- **id** (number) - Required - The unique identifier for the game.

### Request Example
```shell
curl https://ncaa-api.henrygd.me/game/1/play-by-play
```

### Response
#### Success Response (200)
- **playByPlay** (object) - Contains the play-by-play data for the game.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Game Scoring Summary API

Source: https://ncaa-api.henrygd.me/index

Retrieve the scoring summary for a specific game. Note: Some seasons may not return data due to upstream changes.

```APIDOC
## GET /game/{id}/scoring-summary

### Description
Retrieves the scoring summary for a specific game.

### Method
GET

### Endpoint
`/game/{id}/scoring-summary`

### Parameters
#### Path Parameters
- **id** (number) - Required - The unique identifier for the game.

### Request Example
```shell
curl https://ncaa-api.henrygd.me/game/1/scoring-summary
```

### Response
#### Success Response (200)
- **scoringSummary** (object) - Contains the scoring summary data for the game.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Scoreboard API

Source: https://ncaa-api.henrygd.me/index

Retrieve scores for a given sport and division. Date format is typically YYYY/MM/DD, but football uses YYYY/WK. Omitting the date returns scores for today or the previous game date.

```APIDOC
## GET /scoreboard/{sport}/{path}

### Description
Retrieves scores for a specified sport and division.

### Method
GET

### Endpoint
`/scoreboard/{sport}/{path}`

### Parameters
#### Path Parameters
- **sport** (string) - Required - The sport for which to retrieve scores (e.g., football, basketball-men).
- **path** (string) - Required - The specific path for the sport and division (e.g., fbs, fbs/2025/01/all-conf).

### Request Example
```shell
curl 'https://ncaa-api.henrygd.me/scoreboard/{sport}/{path}'
```

### Response
#### Success Response (200)
- **data** (object) - Contains the scoreboard information.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Game Team Stats API

Source: https://ncaa-api.henrygd.me/index

Retrieve team statistics for a specific game. Note: Some seasons may not return data due to upstream changes.

```APIDOC
## GET /game/{id}/team-stats

### Description
Retrieves team statistics for a specific game.

### Method
GET

### Endpoint
`/game/{id}/team-stats`

### Parameters
#### Path Parameters
- **id** (number) - Required - The unique identifier for the game.

### Request Example
```shell
curl https://ncaa-api.henrygd.me/game/1/team-stats
```

### Response
#### Success Response (200)
- **teamStats** (object) - Contains the team statistics for the game.

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Game Boxscore API

Source: https://ncaa-api.henrygd.me/index

Retrieve the boxscore for a specific game. Note: Some seasons may not return data due to upstream changes.

```APIDOC
## GET /game/{id}/boxscore

### Description
Retrieves the boxscore for a specific game.

### Method
GET

### Endpoint
`/game/{id}/boxscore`

### Parameters
#### Path Parameters
- **id** (number) - Required - The unique identifier for the game.

### Request Example
```shell
curl https://ncaa-api.henrygd.me/game/1/boxscore
```

### Response
#### Success Response (200)
- **boxscore** (object) - Contains the boxscore data for the game.

#### Response Example
```json
{
  "example": "response body"
}
```
```
Tokens:
Raw