Live Scores/Games

Returns real-time game state (scheduled / live / final) for a given sport, including scores, status detail, and last-updated freshness. Use this endpoint when you need current game status rather than the static/splits-derived game objects returned by /games.

Use this endpoint for:

Live scoreboards
In-progress game tracking (live score deltas)
Note: state is null for games that haven't started. Once a game is live, state is expected to carry inning/quarter/period-level detail

Example:
https://api.playbook-api.com/v1/live-games?sport=mlb&api_key=YOUR_API_KEY

Historical Data / Date Rang:
For recently completed games, use the paid recentdays parameter:

Example:
https://api.playbook-api.com/v1/live-games?sport=mlb&recentdays=1&status=final&api_key=YOUR_API_KEY

Allowed values: recentdays=1, recentdays=2, recentdays=3.

For the maximum available recent history:
https://api.playbook-api.com/v1/live-games?sport=mlb&recentdays=3&status=final&api_key=YOUR_API_KEY

This includes completed games from the previous three calendar days. It is a rolling window, not an exact-date archive.

{ "success": true, "sport": "mlb", "date": "2026-08-11", "count": 15, "liveCount": 8, "games": [ { "gameId": "pbk_c726593a51445f66a604", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T22:41:00.000Z", "awayTeam": { "id": "cle", "name": "Cleveland Guardians", "abbreviation": "CLE", "score": 3 }, "homeTeam": { "id": "det", "name": "Detroit Tigers", "abbreviation": "DET", "score": 6 }, "state": { "period": 8, "periodLabel": "8th", "segment": "top", "segmentLabel": "Top", "outs": 2, "display": "Top 8th · 2 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_7849fbcc5382db926244", "status": "final", "statusDetail": "Final", "isLive": false, "isFinal": true, "startTime": "2026-08-11T22:41:00.000Z", "awayTeam": { "id": "pit", "name": "Pittsburgh Pirates", "abbreviation": "PIT", "score": 0 }, "homeTeam": { "id": "mia", "name": "Miami Marlins", "abbreviation": "MIA", "score": 2 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_ec1a0e8310154dc099aa", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T22:46:00.000Z", "awayTeam": { "id": "chc", "name": "Chicago Cubs", "abbreviation": "CHC", "score": 7 }, "homeTeam": { "id": "wsh", "name": "Washington Nationals", "abbreviation": "WSH", "score": 4 }, "state": { "period": 7, "periodLabel": "7th", "segment": "bottom", "segmentLabel": "Bottom", "outs": 0, "display": "Bottom 7th · 0 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_c0e629fde77eacacafae", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:08:00.000Z", "awayTeam": { "id": "bos", "name": "Boston Red Sox", "abbreviation": "BOS", "score": 3 }, "homeTeam": { "id": "tor", "name": "Toronto Blue Jays", "abbreviation": "TOR", "score": 4 }, "state": { "period": 7, "periodLabel": "7th", "segment": "top", "segmentLabel": "Top", "outs": 0, "display": "Top 7th · 0 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_398aa1994798561358cd", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:08:00.000Z", "awayTeam": { "id": "sea", "name": "Seattle Mariners", "abbreviation": "SEA", "score": 1 }, "homeTeam": { "id": "nyy", "name": "New York Yankees", "abbreviation": "NYY", "score": 0 }, "state": { "period": 6, "periodLabel": "6th", "segment": "bottom", "segmentLabel": "Bottom", "outs": 0, "display": "Bottom 6th · 0 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_fa5969a085011ab0126b", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:41:00.000Z", "awayTeam": { "id": "bal", "name": "Baltimore Orioles", "abbreviation": "BAL", "score": 5 }, "homeTeam": { "id": "min", "name": "Minnesota Twins", "abbreviation": "MIN", "score": 2 }, "state": { "period": 4, "periodLabel": "4th", "segment": "bottom", "segmentLabel": "Bottom", "outs": 1, "display": "Bottom 4th · 1 Out" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_ebd03b8d3cfbad3721f6", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:41:00.000Z", "awayTeam": { "id": "cin", "name": "Cincinnati Reds", "abbreviation": "CIN", "score": 1 }, "homeTeam": { "id": "cws", "name": "Chicago White Sox", "abbreviation": "CWS", "score": 4 }, "state": { "period": 6, "periodLabel": "6th", "segment": "top", "segmentLabel": "Top", "outs": 0, "display": "Top 6th · 0 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_ee8af065ab33e6cb44d9", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:45:00.000Z", "awayTeam": { "id": "nym", "name": "New York Mets", "abbreviation": "NYM", "score": 0 }, "homeTeam": { "id": "atl", "name": "Atlanta Braves", "abbreviation": "ATL", "score": 2 }, "state": { "period": 7, "periodLabel": "7th", "segment": "bottom", "segmentLabel": "Bottom", "outs": 2, "display": "Bottom 7th · 2 Outs" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_61db901ff5c2fe60884a", "status": "live", "statusDetail": "In Progress", "isLive": true, "isFinal": false, "startTime": "2026-08-11T23:46:00.000Z", "awayTeam": { "id": "phi", "name": "Philadelphia Phillies", "abbreviation": "PHI", "score": 0 }, "homeTeam": { "id": "stl", "name": "St. Louis Cardinals", "abbreviation": "STL", "score": 0 }, "state": { "period": 5, "periodLabel": "5th", "segment": "top", "segmentLabel": "Top", "outs": 1, "display": "Top 5th · 1 Out" }, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_4ca6b92890cc95f985ec", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T01:39:00.000Z", "awayTeam": { "id": "tex", "name": "Texas Rangers", "abbreviation": "TEX", "score": 0 }, "homeTeam": { "id": "laa", "name": "Los Angeles Angels", "abbreviation": "LAA", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_c42455a880a5b04aa551", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T01:41:00.000Z", "awayTeam": { "id": "col", "name": "Colorado Rockies", "abbreviation": "COL", "score": 0 }, "homeTeam": { "id": "ari", "name": "Arizona Diamondbacks", "abbreviation": "ARI", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_b83be15d9d2966ba4dde", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T01:41:00.000Z", "awayTeam": { "id": "tb", "name": "Tampa Bay Rays", "abbreviation": "TB", "score": 0 }, "homeTeam": { "id": "ath", "name": "Athletics", "abbreviation": "ATH", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_cf2d271fbec12d192f1e", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T01:41:00.000Z", "awayTeam": { "id": "mil", "name": "Milwaukee Brewers", "abbreviation": "MIL", "score": 0 }, "homeTeam": { "id": "sd", "name": "San Diego Padres", "abbreviation": "SD", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_7f9e031ac4d18854cbec", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T01:46:00.000Z", "awayTeam": { "id": "hou", "name": "Houston Astros", "abbreviation": "HOU", "score": 0 }, "homeTeam": { "id": "sf", "name": "San Francisco Giants", "abbreviation": "SF", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" }, { "gameId": "pbk_1e20dc71c18c0e37457f", "status": "scheduled", "statusDetail": "Scheduled", "isLive": false, "isFinal": false, "startTime": "2026-08-12T02:11:00.000Z", "awayTeam": { "id": "kc", "name": "Kansas City Royals", "abbreviation": "KC", "score": 0 }, "homeTeam": { "id": "lad", "name": "Los Angeles Dodgers", "abbreviation": "LAD", "score": 0 }, "state": null, "lastUpdated": "2026-08-12T01:01:38.000Z" } ] }

Request

Responses