Get play-by-play for an event
curl --request GET \
--url https://therundown.io/api/v2/events/{eventID}/plays \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/events/{eventID}/plays"
headers = {"X-TheRundown-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-TheRundown-Key': '<api-key>'}};
fetch('https://therundown.io/api/v2/events/{eventID}/plays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://therundown.io/api/v2/events/{eventID}/plays",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-TheRundown-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://therundown.io/api/v2/events/{eventID}/plays"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-TheRundown-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/events/{eventID}/plays")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/events/{eventID}/plays")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-TheRundown-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"event_id": "57be79dde71db0d68fa95e13cb8b9d3d",
"sport_id": 3,
"sport": "mlb",
"plays": [
{
"play_id": 12040643,
"sequence": 297,
"team_id": 54,
"period": 8,
"half_indicator": "bot",
"type": "play_result",
"description": "Bobby Witt doubles",
"scoring_play": false,
"score_away_after": 7,
"score_home_after": 3,
"occurred_at": "2026-09-27T01:14:09.302Z",
"participants": [
{
"player_id": 1641,
"name": "Bobby Witt Jr.",
"team_id": 54,
"role": "batter",
"position": "SS"
},
{
"player_id": 12925668,
"name": "Craig Yoho",
"team_id": 52,
"role": "pitcher",
"position": "RP"
}
],
"mlb": {
"batter": {
"player_id": 1641,
"name": "Bobby Witt Jr.",
"team_id": 54
},
"pitcher": {
"player_id": 12925668,
"name": "Craig Yoho",
"team_id": 52
}
}
}
],
"latest_sequence": 385,
"latest_play_id": 12042886
}{
"error": "before_sequence and after_sequence cannot be combined"
}{
"error": "Live game state requires Ultra plan or higher",
"upgrade_url": "/pricing/api"
}V2 Events
Get play-by-play for an event
Read an event’s play-by-play timeline, periods, game clock and running score. Live game state and play-by-play require Ultra or higher.
GET
/
api
/
v2
/
events
/
{eventID}
/
plays
Get play-by-play for an event
curl --request GET \
--url https://therundown.io/api/v2/events/{eventID}/plays \
--header 'X-TheRundown-Key: <api-key>'import requests
url = "https://therundown.io/api/v2/events/{eventID}/plays"
headers = {"X-TheRundown-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-TheRundown-Key': '<api-key>'}};
fetch('https://therundown.io/api/v2/events/{eventID}/plays', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://therundown.io/api/v2/events/{eventID}/plays",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-TheRundown-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://therundown.io/api/v2/events/{eventID}/plays"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-TheRundown-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/events/{eventID}/plays")
.header("X-TheRundown-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://therundown.io/api/v2/events/{eventID}/plays")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-TheRundown-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"event_id": "57be79dde71db0d68fa95e13cb8b9d3d",
"sport_id": 3,
"sport": "mlb",
"plays": [
{
"play_id": 12040643,
"sequence": 297,
"team_id": 54,
"period": 8,
"half_indicator": "bot",
"type": "play_result",
"description": "Bobby Witt doubles",
"scoring_play": false,
"score_away_after": 7,
"score_home_after": 3,
"occurred_at": "2026-09-27T01:14:09.302Z",
"participants": [
{
"player_id": 1641,
"name": "Bobby Witt Jr.",
"team_id": 54,
"role": "batter",
"position": "SS"
},
{
"player_id": 12925668,
"name": "Craig Yoho",
"team_id": 52,
"role": "pitcher",
"position": "RP"
}
],
"mlb": {
"batter": {
"player_id": 1641,
"name": "Bobby Witt Jr.",
"team_id": 54
},
"pitcher": {
"player_id": 12925668,
"name": "Craig Yoho",
"team_id": 52
}
}
}
],
"latest_sequence": 385,
"latest_play_id": 12042886
}{
"error": "before_sequence and after_sequence cannot be combined"
}{
"error": "Live game state requires Ultra plan or higher",
"upgrade_url": "/pricing/api"
}Endpoint details
Returns the play-by-play timeline for a live or completed event — one entry per play with description, period, game clock, running score, and (as attribution rolls out) the players involved. Live game state and play-by-play require an Ultra plan or higher; keys on lower tiers receive a403. The companion live_game_state snapshot (current inning/quarter, count, base runners, possession, and more) is embedded on live event payloads for entitled keys. Also available for streaming via the plays channel on the V2 WebSocket.Authorizations
Path Parameters
Query Parameters
Catch-up cursor: returns plays with sequence higher than this value, oldest first, up to limit. Pass the highest sequence you already have to fetch newer plays; if a page returns limit plays, repeat with the new highest sequence. Cannot be combined with before_sequence (HTTP 400). 0 or a non-numeric value is ignored.
Required range:
x >= 1Response
Play-by-play timeline