Pitches
GET
/
View as MarkdownTry in Playground →
Baseball only: one at-bat pitch by pitch — type (MLB Statcast categories: four-seam fastball, sinker, cutter, changeup, curveball, slider, sweeper, …), zone, release speed, result, count and outs after each. Each pitch also carries the score, the batted ball (trajectory, hardness) and what the runners and fielders did. Plays that happen between pitches, such as a stolen-base attempt, appear as rows with kind steal.
Other sports get 200 and an empty array. balls / strikes / outs reflect the count AFTER the pitch, and the final pitch (endsAtBat true) carries the at-bat’s result as its outcome. outcome comes from a closed set; when it is other, outcomeCode holds the source’s own code. zone follows MLB Statcast numbering (1–9 inside the strike zone, 11–14 outside it). speedKmh holds the release speed in km/h; multiply it by 0.6214 for mph. For runners, fromBase 0 is the batter, toBase 4 means a run scored, and toBase is null when the runner was put out. Lists saved before 2026-11-04 show AtBat.id as null until they are refreshed.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
atBatIdpathrequired
at-bat identifier, taken from AtBat.id in /v2/fixtures/{id}/points
Response
- data
Pitch[]- meta
- atBatId, count
- errors
- 403
history_not_in_plan— the fixture predates the history your plan covers404not_found— the fixture or at-bat id does not exist
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/fixtures/{id}/at-bats/{atBatId}/pitches"Example
{ "data": [
{ "kind": "steal", "number": 0, "at": "2026-10-18T00:12:56.000Z", "pitchType": null, "outcome": null, "endsAtBat": false,
"balls": 0, "strikes": 0, "outs": 2, "runners": [ { "player": { "id": 9311, "name": "Chandler Simpson" }, "fromBase": 1, "toBase": 1, "out": false } ], … },
{ "kind": "pitch", "number": 1, "at": "2026-10-18T00:13:10.000Z",
"pitcher": { "id": 9301, "name": "Shawn Armstrong", … }, "batter": { "id": 9302, "name": "Junior Caminero", … },
"pitcherHand": "right", "batterHand": "right", "pitchType": "cutter", "pitchName": "Cutter", "speedKmh": 144.84, "zone": 5,
"outcome": "fieldersChoice", "outcomeCode": "oFC", "endsAtBat": true, "balls": 0, "strikes": 0, "outs": 3,
"homeScore": 0, "awayScore": 0, "hit": false, "bunt": false, "wildPitch": false, "passedBall": false,
"doublePlay": false, "triplePlay": false, "overturned": false,
"battedBall": { "trajectory": "groundBall", "hardness": "medium" },
"runners": [ { "player": { "id": 9302, "name": "Junior Caminero" }, "fromBase": 0, "toBase": 1, "out": false },
{ "player": { "id": 9311, "name": "Chandler Simpson" }, "fromBase": 1, "toBase": null, "out": true } ],
"fielders": [] } ],
"meta": { "atBatId": 70412, "count": 2 } }