MLB Stats API Docs

Type to search endpoints by name, path, or keyword.

GET/api/v1.1/game/{gamePk}/feed/live

Live game feed (GUMBO)

The complete real-time state of a game.

GUMBO is the firehose: every play, pitch, player, linescore, and boxscore for a single game in one (large) payload. Note the v1.1 version prefix. Get a gamePk from the schedule endpoint first.

On this page

Try it

Path
Query
https://statsapi.mlb.com/api/v1.1/game/744914/feed/live
const res = await fetch('https://statsapi.mlb.com/api/v1.1/game/744914/feed/live')
const data = await res.json()
curl -s 'https://statsapi.mlb.com/api/v1.1/game/744914/feed/live'

Reference

Path parameters

NameTypeRequiredDescription
gamePknumberyes

Game id from the schedule endpoint.

Query parameters

NameTypeRequiredDescription
timecodestringno

Snapshot the feed at a past moment, YYYYMMDD_HHMMSS. Omit for the latest state.

fieldscsvno

Restrict the response to specific fields to shrink the payload.

Response

Type: GameFeedResponse

/** `GET /api/v1.1/game/{gamePk}/feed/live` */
export interface GameFeedResponse extends WithCopyright {
	gamePk: number
	link: string
	metaData: GameFeedMetaData
	gameData: GameFeedGameData
	liveData: GameFeedLiveData
}

Notes

  • This endpoint is on /api/v1.1/, not /api/v1/.

  • Responses are large (hundreds of KB). Use the fields param, or prefer /linescore and /boxscore sub-resources when you only need part of the state.

  • For polling, use metaData.timeStamp with the diffPatch feed to fetch only what changed.

Build with it

Live examples powered by this endpoint with real data. Inspiration — restyle and remix freely.

Scorebug

Score, inning, count, outs, and the current matchup — the broadcast staple, from one GUMBO call.

Finding a game…

Base-runner diamond

The classic diamond lighting up occupied bases, with the live count and outs.

Finding a game…

Play-by-play ticker

A running feed of the latest plays as they happen.

Finding a game…

Example URLs

  • Full live feed for a game: https://statsapi.mlb.com/api/v1.1/game/744914/feed/live