{ "info": { "name": "Realtime Sports API", "description": "Live scores, play-by-play, box scores, schedules, teams, athletes, injuries, news and betting odds\nfor NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions, under one\nschema and one API key. Push delivery is available over webhooks and WebSocket.\n\n**Freshness:** data is aggregated from public sources and is typically 20-30 seconds behind live play\n(our pipeline adds about 1 second after our source). Not suitable for in-play betting that needs\nsub-second data. There is no SLA.\n\n**Auth:** send `Authorization: Bearer ` (or `X-API-Key: `). Get a free key at\nhttps://www.realtimesportsapi.com/signup.\n\n**Quotas:** monthly call quotas per plan (Free 125/month, 1,000 in the first 30 days; Starter 10,000;\nGrowth 25,000; Pro 50,000; Scale 500,000). Every successful REST call counts as one call. When the quota is\nexhausted the API returns HTTP 429 with a `Retry-After` header. Per-second rates also apply\n(Free 1/s, Starter 5/s, Growth 10/s, Pro 20/s, Scale 100/s). Remaining monthly quota is reported in\n`meta.rateLimit` on most responses.\n\nGenerated from Realtime Sports API OpenAPI spec (https://www.realtimesportsapi.com/openapi.json). Set the `apiKey` collection variable to your key.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "1.0.0" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://www.realtimesportsapi.com/api/v1", "type": "string" }, { "key": "siteUrl", "value": "https://www.realtimesportsapi.com", "type": "string" }, { "key": "apiKey", "value": "YOUR_API_KEY", "type": "string" } ], "item": [ { "name": "Sports", "item": [ { "name": "List sports", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports", "host": [ "{{baseUrl}}" ], "path": [ "sports" ], "variable": [], "query": [] }, "description": "List sports" } }, { "name": "List leagues for a sport", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." } ], "query": [] }, "description": "List leagues for a sport" } }, { "name": "Get league details", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [] }, "description": "Get league details\n\nLeague metadata, current season, and links to related endpoints." } } ] }, { "name": "Events", "item": [ { "name": "List events for a league", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "50", "description": "Maximum events to return (default 50).", "disabled": true }, { "key": "includeOdds", "value": "false", "description": "Attach current betting odds (when available) to each event. Adds latency.", "disabled": true } ] }, "description": "List events for a league\n\nCurrent and upcoming events (the provider's current scoreboard window). For a specific date range or week use the season schedule endpoint." } }, { "name": "List live events", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/live", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", "live" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "includeOdds", "value": "false", "description": "Attach current betting odds (when available) to each event. Adds latency.", "disabled": true } ] }, "description": "List live events\n\nEvents currently in progress (status.state = \"in\"). Returns an empty array when nothing is live. For continuous updates prefer webhooks or the WebSocket stream over tight polling." } }, { "name": "Get an event", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "includeOdds", "value": "false", "description": "Attach current betting odds (when available) to each event. Adds latency.", "disabled": true } ] }, "description": "Get an event" } }, { "name": "Get box score", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/boxscore", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "boxscore" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [] }, "description": "Get box score\n\nTeam totals and player stats. Supported for basketball, soccer, baseball and football. Football players carry per-category stats (passing, rushing, receiving, defensive, kicking, returns) under `categories`." } }, { "name": "Get win probability", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/winprobability", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "winprobability" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "drives", "value": "true", "description": "Include drive summaries (default true).", "disabled": true } ] }, "description": "Get win probability\n\nPer-play win probability series (join to plays via playId) plus drive summaries, where the source publishes them." } }, { "name": "Get game rosters", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/roster", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "roster" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "team", "value": "12", "description": "Return only this team id.", "disabled": true }, { "key": "starters", "value": "false", "description": "Only starters.", "disabled": true }, { "key": "enrich", "value": "true", "description": "Resolve athlete names, teams and positions for play participants (default true). Pass false for faster, id-only results.", "disabled": true } ] }, "description": "Get game rosters\n\nGame-specific rosters with per-player flags (starter, didNotPlay, active). Published by the source at kickoff." } } ] }, { "name": "Plays", "item": [ { "name": "Get play-by-play", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/plays", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "plays" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "limit", "value": "25", "description": "Maximum plays to return (default 25, max 1000).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true }, { "key": "enrich", "value": "true", "description": "Resolve athlete names, teams and positions for play participants (default true). Pass false for faster, id-only results.", "disabled": true } ] }, "description": "Get play-by-play\n\nPlays in chronological order, paginated. Use `limit` up to 1000 to fetch a whole game in one call." } }, { "name": "Get penalty plays", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/penalties", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "penalties" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "enrich", "value": "true", "description": "Resolve athlete names, teams and positions for play participants (default true). Pass false for faster, id-only results.", "disabled": true } ] }, "description": "Get penalty plays\n\nOnly the penalty plays of an event; all plays are scanned, not just one page." } } ] }, { "name": "Odds", "item": [ { "name": "Get current odds", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/odds", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "odds" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [] }, "description": "Get current odds\n\nCurrent spread, moneyline and total from a single source book. `data` is null (with a `message`) when no odds are available." } }, { "name": "Get odds history", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/events/:eventId/odds/history", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "events", ":eventId", "odds", "history" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "eventId", "value": "401772982", "description": "Event (game) id, as returned by the events endpoints." } ], "query": [ { "key": "limit", "value": "100", "description": "Maximum snapshots to return (default 100).", "disabled": true } ] }, "description": "Get odds history\n\nSnapshots recorded each time the line changed, newest first." } } ] }, { "name": "Teams", "item": [ { "name": "List teams", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/teams", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "teams" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "50", "description": "Maximum teams to return (default 50, max 200).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true } ] }, "description": "List teams\n\nPaginated. College football has 800+ teams across all divisions; for FBS only use the group endpoint (/seasons/{season}/types/2/groups/80/teams)." } }, { "name": "Get a team", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/teams/:teamId", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "teams", ":teamId" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "teamId", "value": "12", "description": "Team id, as returned by the teams endpoints." } ], "query": [] }, "description": "Get a team" } }, { "name": "Get team roster", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/teams/:teamId/roster", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "teams", ":teamId", "roster" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "teamId", "value": "12", "description": "Team id, as returned by the teams endpoints." } ], "query": [ { "key": "season", "value": "2025", "description": "Historical season year.", "disabled": true } ] }, "description": "Get team roster\n\nCurrent roster grouped by position plus a flat list. Pass `season` for a historical season roster (flat list)." } }, { "name": "Get depth chart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/teams/:teamId/depthchart", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "teams", ":teamId", "depthchart" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "teamId", "value": "12", "description": "Team id, as returned by the teams endpoints." } ], "query": [ { "key": "season", "value": "2026", "description": "Season year (defaults to current).", "disabled": true } ] }, "description": "Get depth chart" } } ] }, { "name": "Athletes", "item": [ { "name": "List athletes", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/athletes", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "athletes" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "25", "description": "Maximum athletes to return (default 25).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true }, { "key": "include", "value": "statistics", "description": "Pass `statistics` to attach stats to each athlete (slower).", "disabled": true } ] }, "description": "List athletes\n\nPaginated. Some leagues have tens of thousands of athletes; prefer team rosters or search." } }, { "name": "Search athletes by name", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/athletes/search?query=mahomes", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "athletes", "search" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "query", "value": "mahomes", "description": "Name to search for (`q` is accepted as an alias).", "disabled": false }, { "key": "limit", "value": "25", "description": "Maximum results to return (default 25).", "disabled": true } ] }, "description": "Search athletes by name" } }, { "name": "Get an athlete", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/athletes/:athleteId", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "athletes", ":athleteId" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "athleteId", "value": "3139477", "description": "Athlete id, as returned by the athletes endpoints." } ], "query": [ { "key": "season", "value": "2025", "description": "Scope statistics to a season year.", "disabled": true }, { "key": "seasonType", "value": "2", "description": "1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.", "disabled": true } ] }, "description": "Get an athlete\n\nAthlete profile with statistics. Omit season for career/current totals." } }, { "name": "Get athlete game log", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/athletes/:athleteId/gamelog?season=2026", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "athletes", ":athleteId", "gamelog" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "athleteId", "value": "3139477", "description": "Athlete id, as returned by the athletes endpoints." } ], "query": [ { "key": "season", "value": "2026", "description": "Season year.", "disabled": false }, { "key": "week", "value": "5", "description": "Only this week.", "disabled": true }, { "key": "seasonType", "value": "2", "description": "1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.", "disabled": true } ] }, "description": "Get athlete game log" } }, { "name": "Get athlete availability history", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/athletes/:athleteId/availability-history", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "athletes", ":athleteId", "availability-history" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "athleteId", "value": "3139477", "description": "Athlete id, as returned by the athletes endpoints." } ], "query": [ { "key": "limit", "value": "100", "description": "Maximum transitions to return (default 100, max 500).", "disabled": true }, { "key": "from", "value": "2026-09-01T00:00:00Z", "description": "Only items on or after this ISO-8601 timestamp.", "disabled": true }, { "key": "to", "value": "2026-10-01T00:00:00Z", "description": "Only items on or before this ISO-8601 timestamp.", "disabled": true } ] }, "description": "Get athlete availability history\n\nTime series of a player's injury/availability designations, newest first, as observed by our snapshots (every 30 minutes)." } } ] }, { "name": "Seasons", "item": [ { "name": "Get the active season", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/season", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "season" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [] }, "description": "Get the active season" } }, { "name": "List seasons", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "25", "description": "Maximum seasons to return (default 25).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true } ] }, "description": "List seasons" } }, { "name": "Get a season", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." } ], "query": [] }, "description": "Get a season" } }, { "name": "Get season schedule", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/schedule", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "schedule" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." } ], "query": [ { "key": "week", "value": "5", "description": "Week number (NFL and college-football only).", "disabled": true }, { "key": "seasonType", "value": "2", "description": "1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.", "disabled": true }, { "key": "includeOdds", "value": "false", "description": "Attach current betting odds (when available) to each event. Adds latency.", "disabled": true } ] }, "description": "Get season schedule\n\nEvents 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\"." } }, { "name": "List weeks in a season", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/weeks", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "weeks" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." } ], "query": [ { "key": "seasonType", "value": "2", "description": "1 = preseason, 2 = regular season, 3 = postseason. `type` is accepted as an alias.", "disabled": true } ] }, "description": "List weeks in a season\n\nNFL and college football only." } }, { "name": "List season types", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/types", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "types" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." } ], "query": [] }, "description": "List season types" } }, { "name": "Get a season type", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/types/:typeId", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "types", ":typeId" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." }, { "key": "typeId", "value": "2", "description": "Season type id: 1 = preseason, 2 = regular season, 3 = postseason (4 = off-season for some leagues)." } ], "query": [] }, "description": "Get a season type" } }, { "name": "List groups (conferences/divisions)", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "types", ":typeId", "groups" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." }, { "key": "typeId", "value": "2", "description": "Season type id: 1 = preseason, 2 = regular season, 3 = postseason (4 = off-season for some leagues)." } ], "query": [] }, "description": "List groups (conferences/divisions)" } }, { "name": "Get a group", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups/:groupId", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "types", ":typeId", "groups", ":groupId" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." }, { "key": "typeId", "value": "2", "description": "Season type id: 1 = preseason, 2 = regular season, 3 = postseason (4 = off-season for some leagues)." }, { "key": "groupId", "value": "80", "description": "Group (conference/division) id. College football: 80 = FBS, 81 = FCS." } ], "query": [] }, "description": "Get a group" } }, { "name": "List teams in a group", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/types/:typeId/groups/:groupId/teams", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "types", ":typeId", "groups", ":groupId", "teams" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." }, { "key": "typeId", "value": "2", "description": "Season type id: 1 = preseason, 2 = regular season, 3 = postseason (4 = off-season for some leagues)." }, { "key": "groupId", "value": "80", "description": "Group (conference/division) id. College football: 80 = FBS, 81 = FCS." } ], "query": [ { "key": "pageSize", "value": "25", "description": "Teams per page (default 25, max 200). `limit` is accepted as an alias.", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true } ] }, "description": "List teams in a group" } }, { "name": "List a team's events in a season", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/teams/:teamId/events", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "teams", ":teamId", "events" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." }, { "key": "teamId", "value": "12", "description": "Team id, as returned by the teams endpoints." } ], "query": [ { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true }, { "key": "pageSize", "value": "25", "description": "Source page size (default 25).", "disabled": true }, { "key": "limit", "value": "50", "description": "Maximum events from the page to return (default 50).", "disabled": true } ] }, "description": "List a team's events in a season" } }, { "name": "Get NCAA tournament games", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/seasons/:season/tournament", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "seasons", ":season", "tournament" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." }, { "key": "season", "value": "2026", "description": "Season year, e.g. 2026." } ], "query": [ { "key": "round", "value": "Sweet 16", "description": "Round label filter (substring, case-insensitive).", "disabled": true }, { "key": "region", "value": "South", "description": "Region name filter.", "disabled": true }, { "key": "firstFour", "value": "", "description": "true = only First Four games, false = exclude them.", "disabled": true }, { "key": "startDate", "value": "20260317", "description": "Override scan window start (YYYYMMDD).", "disabled": true }, { "key": "endDate", "value": "20260407", "description": "Override scan window end (YYYYMMDD).", "disabled": true } ] }, "description": "Get NCAA tournament games\n\nNCAA tournament games for a season with region, round and First Four flag. Basketball only; excludes NIT/CBI/CIT." } } ] }, { "name": "Injuries & Availability", "item": [ { "name": "Get injury report", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/injuries", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "injuries" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true } ] }, "description": "Get injury report\n\nCurrent injuries grouped by team. Without `team` the league-wide feed is truncated by the source to the 25 most recent records per team; with `team` the complete current report is returned. Empty in the off-season." } }, { "name": "Get normalized player availability", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/player-availability", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "player-availability" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true }, { "key": "status", "value": "OUT", "description": "Filter to one normalized availability value.", "disabled": true } ] }, "description": "Get normalized player availability\n\nOne normalized `availability` value per player (OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, DAY_TO_DAY, INJURED_RESERVE, SUSPENDED, AVAILABLE, UNKNOWN)." } }, { "name": "Get availability changes feed", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/player-availability/history", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "player-availability", "history" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true }, { "key": "since", "value": "2026-09-01T00:00:00Z", "description": "Only changes at or after this time.", "disabled": true }, { "key": "status", "value": "OUT", "description": "Filter to one normalized availability value.", "disabled": true }, { "key": "limit", "value": "100", "description": "Maximum changes to return (default 100, max 500).", "disabled": true } ] }, "description": "Get availability changes feed\n\nLeague-wide feed of availability designation changes, newest first." } } ] }, { "name": "News", "item": [ { "name": "Get latest news", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/news", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "news" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "10", "description": "Maximum articles to return (default 10, max 50).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true }, { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true }, { "key": "athlete", "value": "3139477", "description": "Only articles tagged with this athlete id.", "disabled": true }, { "key": "since", "value": "", "description": "Alias of `from`.", "disabled": true }, { "key": "from", "value": "2026-09-01T00:00:00Z", "description": "Only items on or after this ISO-8601 timestamp.", "disabled": true }, { "key": "to", "value": "2026-10-01T00:00:00Z", "description": "Only items on or before this ISO-8601 timestamp.", "disabled": true } ] }, "description": "Get latest news\n\nRolling window of recent articles from the source. For older articles use /news/history." } }, { "name": "Get archived news", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/news/history", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "news", "history" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "from", "value": "2026-09-01T00:00:00Z", "description": "Only items on or after this ISO-8601 timestamp.", "disabled": true }, { "key": "to", "value": "2026-10-01T00:00:00Z", "description": "Only items on or before this ISO-8601 timestamp.", "disabled": true }, { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true }, { "key": "athlete", "value": "3139477", "description": "Only articles tagged with this athlete id.", "disabled": true }, { "key": "limit", "value": "25", "description": "Maximum articles to return (default 25, max 100).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true } ] }, "description": "Get archived news\n\nOur archive of league news, newest first. The archive begins 2026-09-02." } } ] }, { "name": "Transactions", "item": [ { "name": "Get transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/sports/:sport/leagues/:league/transactions", "host": [ "{{baseUrl}}" ], "path": [ "sports", ":sport", "leagues", ":league", "transactions" ], "variable": [ { "key": "sport", "value": "football", "description": "Sport slug: football, basketball, baseball, hockey, soccer." }, { "key": "league", "value": "nfl", "description": "League slug, e.g. nfl, college-football, nba, mens-college-basketball, mlb, nhl, eng.1, usa.1." } ], "query": [ { "key": "limit", "value": "25", "description": "Maximum transactions to return (default 25).", "disabled": true }, { "key": "page", "value": "1", "description": "Page number (1-based).", "disabled": true }, { "key": "team", "value": "12", "description": "Filter to one team id.", "disabled": true }, { "key": "season", "value": "2026", "description": "Season year.", "disabled": true } ] }, "description": "Get transactions\n\nRecent signings, injured-list moves, call-ups, releases and trades. Empty in the off-season." } } ] }, { "name": "Webhooks", "item": [ { "name": "List your webhooks", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "webhooks" ], "variable": [], "query": [] }, "description": "List your webhooks\n\nRequires a paid plan." } }, { "name": "Create a webhook", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "webhooks" ], "variable": [], "query": [] }, "description": "Create a webhook\n\nDeliveries are signed with HMAC-SHA256 in the `X-Webhook-Signature` header. The signing secret is returned only in this response (retrieve it later via /webhooks/{webhookId}/secret).", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://example.com/hooks/sports\",\n \"events\": [\n \"event.score_change\"\n ],\n \"leagues\": [\n \"nfl\"\n ],\n \"frequency\": \"asap\",\n \"active\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a webhook", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Get a webhook" } }, { "name": "Update a webhook", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Update a webhook\n\nPartial update of any of url, events, leagues, frequency, active. `active: true` re-enables an automatically deactivated webhook.", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://example.com/hooks/sports\",\n \"events\": [\n \"event.score_change\"\n ],\n \"leagues\": [\n \"nfl\"\n ],\n \"frequency\": \"asap\",\n \"active\": true\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a webhook", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Delete a webhook" } }, { "name": "Reveal the signing secret", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId/secret", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId", "secret" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Reveal the signing secret" } }, { "name": "Rotate the signing secret", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId/secret", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId", "secret" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Rotate the signing secret\n\nThe old secret stops being used within about one second." } }, { "name": "Send a test delivery", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId/test", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId", "test" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [] }, "description": "Send a test delivery\n\nSends a signed sample payload (header `X-Webhook-Test: true`), or replays a recorded failed delivery when `deliveryId` is given.", "body": { "mode": "raw", "raw": "{\n \"eventType\": \"event.score_change\",\n \"deliveryId\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List failed deliveries", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/:webhookId/deliveries", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", ":webhookId", "deliveries" ], "variable": [ { "key": "webhookId", "value": "3fK9xQ2mLp7Rz1Vb", "description": "Webhook id, as returned by GET /webhooks." } ], "query": [ { "key": "limit", "value": "50", "description": "Maximum deliveries to return (default 50, max 200).", "disabled": true } ] }, "description": "List failed deliveries\n\nRecent failed delivery attempts. Successful deliveries are not recorded individually." } } ] }, { "name": "WebSocket", "item": [ { "name": "Get a WebSocket token", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{siteUrl}}/api/websocket/auth", "host": [ "{{siteUrl}}/api" ], "path": [ "websocket", "auth" ], "variable": [], "query": [] }, "description": "Get a WebSocket token\n\nReturns the WebSocket URL and a token valid for one hour. Connect to `${url}?token=${token}`, then send `{\"type\":\"subscribe\",\"event\":\"event_score_change\",\"filters\":{\"sport\":\"football\",\"league\":\"nfl\"}}`. Event types: event_score_change, event_live, event_status_change, event_play, event_final, event_odds_change. Each delivered message counts toward your quota." } } ] } ] }