# NCAAF API for Scores, Schedules, Odds & AI Agents

> HTML twin: [/sports/ncaaf-api](/sports/ncaaf-api)

College-football sports API landing — schedules, live scores, multi-book odds, Stage-1 raw team stats, and seasonal bet intelligence. Canonical for **NCAAF API** / **college football API** intent (odds are an H2 here; no separate `/odds/ncaaf-odds-api`).

Filter: `sport=ncaaf` (league slug `ncaaf`).

## Available data

| Layer | Endpoint | NCAAF notes |
|---|---|---|
| Schedule / board | `GET /v1/events` | `sport=ncaaf`; status, date, `include_odds` / `include_scores` |
| Live score | `GET /v1/events/{id}/score` · SSE | Periods `1`–`4` / `OT`; `clock` when available |
| Odds | `GET …/odds` · `…/odds/history` | Two-way `h2h`, spreads, totals · 9 books |
| Player props | `GET …/player-props` | Settleable yards / TD / receptions mains + live box progress |
| Splits | `GET …/splits` | **Not available** for NCAAF |
| Intelligence | `GET …/intelligence` | Seasonal points model · SP+/efficiency signals |
| Raw stats | `GET …/stats` | Stage-1 team context (record, form, H2H, rest, offense/defense rates) |

## Schedules

`GET /v1/events?sport=ncaaf` — status, `date` or `from`/`to` (max 90 days/request), `after_id` / `limit`. Teams: `GET /v1/teams?sport=ncaaf`. Seasons: `GET /v1/seasons?sport=ncaaf`.

## Scores

Football period labels (`1`–`4`, `OT`) + `clock`. Live board: `?sport=ncaaf&status=inprogress&include_scores=true`. Poll `/score` or SSE `/stream`.

## Odds

Two-way moneyline / spreads / totals. Default Pinnacle or `bookmaker=all` = 1 credit. Game markets only. Cross-sport detail: [/sports-odds-api](/sports-odds-api).

## Player props

`GET /v1/events/{id}/player-props` (1 credit when lines exist; `available:false` is free). MCP: `get_player_props`. Same football catalog as NFL. Market keys: [/docs/player-props](/docs/player-props). Endpoint fields: [/docs/reference#event-player-props](/docs/reference#event-player-props).

## Intelligence

Points model (seasonal — `available: false` offseason). Tokens: `ML_P1`/`ML_P2`, `SPREAD_P1`/`SPREAD_P2`, `OVER`/`UNDER`. College signals are SP+/efficiency-style (`signals._labels`). **No betting splits** for NCAAF — pair with `/odds` and `/stats`. Pro football: [/sports/nfl-api](/sports/nfl-api).

## Raw stats

`GET /v1/events/{id}/stats` — Stage-1 **NCAAF-native** team context (same football catalog as NFL, scoped to `ncaaf`). Judgment stays on `/intelligence`. Check `available`. Fields: [/docs/reference#event-stats](/docs/reference#event-stats).

## Sportsbooks

Odds: `pinnacle`, `fanduel`, `draftkings`, `betmgm`, `caesars`, `bet365`, `circa`, `hardrock`, `betonline`.

## Example — NCAAF slate with odds

```bash
curl "https://lumify.ai/v1/events?sport=ncaaf&status=scheduled&include_odds=true&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python
from lumify import Lumify

client = Lumify(api_key="YOUR_API_KEY")
page = client.events.list(
    sport="ncaaf",
    status="scheduled",
    include_odds=True,
    limit=5,
)
```

```ts
import { Lumify } from "@lumifyai/sdk";

const client = new Lumify({ apiKey: "YOUR_API_KEY" });
const { events } = await client.events.list({
  sport: "ncaaf",
  status: "scheduled",
  includeOdds: true,
  limit: 5,
});
```

## Example — intelligence

```bash
curl "https://lumify.ai/v1/events/5102/intelligence" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Freshness

| Feed | Cadence |
|---|---|
| Scores | ~1 minute (+ SSE/webhooks) |
| Odds | ~10 minutes (2-min response cache) |
| Stats | Scheduled box ingest (persist-then-read) |
| Intelligence | After analysis runs (in-season) |

## Pricing

| Call | Credits |
|---|---|
| Most successful GETs | 1 |
| `bookmaker=all` or a list | 1 |
| `available: false` / errors | 0 |

Free Tier: 1,000 credits (never expire). Instant trial: 100 / 14 days. Details: [/pricing](/pricing).

## Related

- [NFL API](/sports/nfl-api)
- [NCAAB API](/sports/ncaab-api)
- [NBA API](/sports/nba-api)
- [MLB API](/sports/mlb-api)
- [Sports Data API](/sports-data-api)
- [Sports Odds API](/sports-odds-api)
- [Sports API for AI Agents](/sports-api-for-ai-agents)
- [Sports MCP Server](/sports-mcp-server)
- [Events reference](/docs/reference#events)
- [Intelligence reference](/docs/reference#event-intelligence)