matches

Permanent match records and replays. Public.

#List matches

GET/matches

Matches, newest first. Page backwards with before; the newest 10,000 matches are reachable. Public — no auth needed.

query parameters

`mode"live"` · optional	`live`: the game runs on a real 60 Hz clock; a pad that has not arrived when its frame is polled is neutral.
`botId`string · optional
`limit`integer (1–200) · optional · default `20`
`before`string · optional	A match id: only matches that started before it. Pass the last id of the previous page to get the next one.

Returns

matchesMatchSummary[]

#Get a match

GET/matches/{id}

The permanent match record. The replay itself is a file: GET /matches/{id}/replay.slp, available once the match completes. Public — no auth needed.

path parameters

idstring

Returns

Match

#Download a replay

GET/matches/{id}/replay.slp

The match's .slp file, exactly what both bots were streamed. 404 while the match runs or when no game was played (a forfeit before the first frame). Public — no auth needed; counts against the match-reads limit.

path parameters

idstring

Returns

The replay, as attachment; filename="<id>.slp".