Season schedule and weeks API
Games for a season, optionally one week (NFL and college football), and the list of weeks with their date ranges. The active season endpoint returns the current season and its types. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
- Week parameters are only accepted for NFL and college football.
- Without week, results come from our synced store (about the next week), falling back to the live source.
Paths and parameters
GET/api/v1/sports/{sport}/leagues/{league}/seasons/{season}/schedule
Get season schedule. Events for a season, optionally one week (NFL and college football only). With `week`, our synced store (which covers about the next week) is merged with the live scoreboard so future weeks are complete. Without `week`, up to 200 events from the synced store, falling back to the live source. `meta.source` is "synced", "live" or "merged".
sport(path, required): Sport slug: football, basketball, baseball, hockey, soccer.league(path, required): League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1.season(path, required): Season year, e.g. 2026.week(query): Week number (NFL and college-football only).seasonType(query): 1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.includeOdds(query): Attach current betting odds (when available) to each event. Adds latency.
GET/api/v1/sports/{sport}/leagues/{league}/seasons/{season}/weeks
List weeks in a season. NFL and college football only.
sport(path, required): Sport slug: football, basketball, baseball, hockey, soccer.league(path, required): League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1.season(path, required): Season year, e.g. 2026.seasonType(query): 1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.
GET/api/v1/sports/{sport}/leagues/{league}/season
Get the active season
sport(path, required): Sport slug: football, basketball, baseball, hockey, soccer.league(path, required): League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1.
Live example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/seasons/2026/weeks?seasonType=2"Response captured from live data at 2026-10-05 02:14 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.
Response
{
"success": true,
"data": [
{
"number": 1,
"seasonType": 2,
"label": "Week 1",
"startDate": "2026-09-06T07:00Z",
"endDate": "2026-09-16T06:59Z"
},
{
"number": 2,
"seasonType": 2,
"label": "Week 2",
"startDate": "2026-09-16T07:00Z",
"endDate": "2026-09-23T06:59Z"
},
{
"number": 3,
"seasonType": 2,
"label": "Week 3",
"startDate": "2026-09-23T07:00Z",
"endDate": "2026-09-30T06:59Z"
},
"... 15 more"
],
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1793491200000
}
}
}Fields
| Field | Type | Notes |
|---|---|---|
| number | integer | |
| seasonType | integer | |
| label | string | |
| startDate | string | |
| endDate | string |
League support
Checked against live data on 2026-10-04: 16 available, 13 limited, 0 seasonal or not verified, 0 not available.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Date-range lookups for this competition may be incomplete; the current scoreboard (/events) is reliable.
Code samples
curl
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/seasons/2026/weeks?seasonType=2"JavaScript (fetch)
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/seasons/2026/weeks?seasonType=2", {
headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);Python (requests)
import os, requests
res = requests.get(
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/seasons/2026/weeks?seasonType=2",
headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
timeout=10,
)
body = res.json()
print(body["data"])MCP prompt (Claude, Cursor, ChatGPT)
Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_schedule with sport "football" and league "nfl" and list the games in the next seven days for NFL.Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.
Rate limits and pricing
| Plan | Price | Calls | Rate | WebSocket | Webhooks |
|---|---|---|---|---|---|
| Free | $0 | 125/mo (1,000 first 30 days) | 1/s | 500 msgs/mo | No |
| Starter | $29/mo ($290/yr) | 10,000/mo | 5/s | Shares monthly pool | Shares monthly pool |
| Growth | $49/mo ($490/yr) | 25,000/mo | 10/s | Shares monthly pool | Shares monthly pool |
| Pro | $99/mo ($990/yr) | 50,000/mo | 20/s | 100,000 msgs/mo | 25,000/mo |
| Scale | $299/mo ($2,990/yr) | 500,000/mo | 100/s | 500,000 msgs/mo | 100,000/mo |
Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.
FAQ
- What does the schedule / weeks endpoint return?
- Games for a season, optionally one week (NFL and college football), and the list of weeks with their date ranges. The active season endpoint returns the current season and its types.
- Which leagues support schedule / weeks?
- Verified on 2026-10-04: NFL, College Football, NBA, Men's College Basketball, MLB, NHL, MLS, Premier League, LaLiga, Serie A, Liga MX, Women's Super League, Bundesliga, Ligue 1, NWSL, EFL Championship. Limited: U.S. Open Cup, Champions League, Europa League, FA Cup, FIFA World Cup, Women's Champions League, Conference League, English League Cup, World Cup Qualifying (UEFA), World Cup Qualifying (CONMEBOL), World Cup Qualifying (AFC), World Cup Qualifying (CAF), World Cup Qualifying (CONCACAF).
- Is it free to try?
- Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. Every successful call counts as one call.
- How fresh is the data?
- Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
- Can I get updates pushed instead of polling?
- Webhooks are included on every paid plan (Starter, Growth, Pro, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview.