Events and scoreboard API
The league's current scoreboard window: recent finals, live games and upcoming games, with teams, scores, status, venue, season/week and broadcast info. 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.
- The window is whatever the league's current scoreboard covers (often a day for daily leagues, a week for NFL). On daily leagues it can still show the previous day until mid-morning Eastern, so pass date=YYYY-MM-DD for a specific US Eastern day. For a week or season use the schedule endpoint.
Paths and parameters
GET/api/v1/sports/{sport}/leagues/{league}/events
List events for a league. Current and upcoming events (the provider's current scoreboard window). Pass date=YYYY-MM-DD for one US Eastern day: on daily leagues the default window can still show the previous day's games until mid-morning Eastern. For a week or season use the season schedule endpoint.
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.limit(query): Maximum events to return (default 50).date(query): One US Eastern calendar day (YYYY-MM-DD). Omit for the current scoreboard window.includeOdds(query): Attach current betting odds (when available) to each event. Adds latency.
Live example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=1"Response captured from live data at 2026-11-21 21:32 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.
Response
{
"success": true,
"data": [
{
"id": "401873066",
"uid": "s:20~l:28~e:401873066",
"name": "Indianapolis Colts at Houston Texans",
"shortName": "IND @ HOU",
"date": "2026-11-20T01:15Z",
"status": {
"state": "post",
"completed": true,
"period": 4,
"clock": "0:00",
"detail": "Final",
"halftime": false,
"firstHalfEnded": true
},
"homeTeam": {
"id": "34",
"name": "Houston Texans",
"abbreviation": "HOU",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0HVl9AUlxGC0IcSkoYVg",
"color": "021018",
"alternateColor": "eb0028",
"winner": true,
"score": 26
},
"awayTeam": {
"id": "11",
"name": "Indianapolis Colts",
"abbreviation": "IND",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0HVl9AUlxGCkMNSkoYVg",
"color": "003b75",
"alternateColor": "ffffff",
"winner": false,
"score": 3
},
"competition": {
"attendance": 70942,
"neutralSite": false,
"conferenceCompetition": false,
"divisionCompetition": false,
"playByPlayAvailable": true,
"highlightsAvailable": true
},
"venue": {
"id": "3891",
"name": "Reliant Stadium",
"city": "Houston",
"state": "TX",
"indoor": true,
"grass": false
},
"notes": [],
"season": {
"year": 2026,
"displayName": "2026",
"type": {
"id": "2",
"name": "Regular Season",
"abbreviation": "reg"
},
"week": {
"number": 11,
"startDate": "2026-11-18T08:00Z",
"endDate": "2026-11-25T07:59Z",
"text": "Week 11"
}
},
"broadcasts": [
{
"network": "Prime Video",
"type": "Streaming"
}
],
"officials": [
{
"id": "17664",
"fullName": "Dino Paganelli",
"displayName": "Dino Paganelli",
"order": 2,
"position": "Back Judge"
},
{
"id": "17671",
"fullName": "Dyrol Prioleau",
"displayName": "Dyrol Prioleau",
"order": 3,
"position": "Field Judge"
},
{
"id": "17676",
"fullName": "Jeff Seeman",
"displayName": "Jeff Seeman",
"order": 1,
"position": "Line Judge"
},
"... 4 more"
]
}
],
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}Fields
| Field | Type | Notes |
|---|---|---|
| id | string | Event id; use it with the detail, plays, box score and odds endpoints. |
| uid | string | |
| name | string | Full matchup name. |
| shortName | string | Abbreviated matchup, e.g. "AWAY @ HOME". |
| date | string | Start time, ISO-8601 UTC. |
| status | EventStatus | state (pre, in, post), completed, period, clock and display detail. |
| homeTeam | EventTeam | id, name, abbreviation, colors, logo (proxied), record, score, winner. |
| awayTeam | EventTeam | Same shape as homeTeam. |
| competition | object | attendance, neutralSite, conference/division flags, playByPlayAvailable. |
| venue | object | Venue id, name, city, state, indoor, grass (null when unknown). |
| notes | string[] | Headline notes, e.g. round or rivalry names. |
| season | object | year, type (preseason/regular/postseason) and week where the league uses weeks. |
| broadcasts | object[] | TV/stream networks for the game. |
| officials | object[] | Game officials when published. |
| odds | Odds | Only with includeOdds=true and when the game has odds. |
League support
Checked against live data on 2026-10-04: 29 available, 0 limited, 0 seasonal or not verified, 0 not available.
Code samples
curl
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=1"JavaScript (fetch)
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/events?limit=1", {
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/events?limit=1",
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_events with sport "football" and league "nfl" and list the games it returns with start times, status and scores for NFL.Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.
Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans
Shipping a product with this data?
Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.
- Score alerts for your sports app, without pollingWebhooks into your backend, then FCM/APNs · Starter ($29/mo)
- Live scoreboards and game pages for news and media sitesCached REST on your server; optional WebSocket for live ticks · Starter ($29/mo)
- Player stats and box scores for fantasy platformsREST box scores during games, webhooks for finals and plays · Growth ($49/mo)
- Live scores on the screens in your venueFree widget, or one WebSocket feeding every screen · Starter ($29/mo)
- A play-by-play feed for your analytics stackWebSocket for live plays, REST to backfill and reconcile · Growth ($49/mo)
- Stream live scores to your backend over WebSocketWebSocket (server to server) · Starter ($29/mo)
- Sports data for a startup, from prototype to scaleREST, WebSocket and webhooks on one key · Starter ($29/mo)
Guides
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 |
| Business | $179/mo ($1,790/yr) | 150,000/mo | 40/s | 300,000 msgs/mo | 75,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 events (scoreboard) endpoint return?
- The league's current scoreboard window: recent finals, live games and upcoming games, with teams, scores, status, venue, season/week and broadcast info.
- Which leagues support events (scoreboard)?
- All 29 monitored leagues returned data when we checked on 2026-10-04.
- 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, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview.