MLB Stats API Docs

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

GET/api/v1/game/changes

Game changes

Games updated since a given timestamp.

A polling helper: returns the schedule of games that changed since updatedSince, so you can refresh only what moved.

On this page

Try it

Query
https://statsapi.mlb.com/api/v1/game/changes?updatedSince=2026-06-28T00%3A00%3A00Z&sportId=1
const res = await fetch('https://statsapi.mlb.com/api/v1/game/changes?updatedSince=2026-06-28T00%3A00%3A00Z&sportId=1')
const data = await res.json()
curl -s 'https://statsapi.mlb.com/api/v1/game/changes?updatedSince=2026-06-28T00%3A00%3A00Z&sportId=1'

Reference

Query parameters

NameTypeRequiredDescription
updatedSincestringyes

ISO 8601 timestamp, e.g. 2026-06-28T00:00:00Z.

sportIdnumberno

Sport id. 1 is MLB.

Response

Type: ScheduleResponse

/** `GET /api/v1/schedule` */
export interface ScheduleResponse extends WithCopyright {
	totalItems: number
	totalEvents: number
	totalGames: number
	totalGamesInProgress: number
	dates: ScheduleDate[]
}

Notes

  • Same response shape as /schedule.

Build with it

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

Recently updated games

A polling helper turned into a board of games that changed in the last few hours.

Loading changes…

Example URLs

  • Games changed since a timestamp: https://statsapi.mlb.com/api/v1/game/changes?updatedSince=2026-06-28T00%3A00%3A00Z&sportId=1