Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Fixtures

Pitches

GET

/v2/fixtures/{id}/at-bats/{atBatId}/pitches

Pro and up

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

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

atBatId

pathrequired

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 covers404 not_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 } }