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.

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

FieldTypeNotes
idstringEvent id; use it with the detail, plays, box score and odds endpoints.
uidstring
namestringFull matchup name.
shortNamestringAbbreviated matchup, e.g. "AWAY @ HOME".
datestringStart time, ISO-8601 UTC.
statusEventStatusstate (pre, in, post), completed, period, clock and display detail.
homeTeamEventTeamid, name, abbreviation, colors, logo (proxied), record, score, winner.
awayTeamEventTeamSame shape as homeTeam.
competitionobjectattendance, neutralSite, conference/division flags, playByPlayAvailable.
venueobjectVenue id, name, city, state, indoor, grass (null when unknown).
notesstring[]Headline notes, e.g. round or rivalry names.
seasonobjectyear, type (preseason/regular/postseason) and week where the league uses weeks.
broadcastsobject[]TV/stream networks for the game.
officialsobject[]Game officials when published.
oddsOddsOnly 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.

Guides

Rate limits and pricing

PlanPriceCallsRateWebSocketWebhooks
Free$0125/mo (1,000 first 30 days)1/s500 msgs/moNo
Starter$29/mo ($290/yr)10,000/mo5/sShares monthly poolShares monthly pool
Growth$49/mo ($490/yr)25,000/mo10/sShares monthly poolShares monthly pool
Pro$99/mo ($990/yr)50,000/mo20/s100,000 msgs/mo25,000/mo
Business$179/mo ($1,790/yr)150,000/mo40/s300,000 msgs/mo75,000/mo
Scale$299/mo ($2,990/yr)500,000/mo100/s500,000 msgs/mo100,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.