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

Group: Fixtures

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.

Plans: Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | fixture id issued by DataSportsAPI, a positive integer |
| `atBatId` | path | yes | at-bat identifier, taken from AtBat.id in /v2/fixtures/{id}/points |

## Response

- `data`: `Pitch[]`
- `meta`: atBatId, count
- Objects: Pitch (https://datasportsapi.com/markdown/reference.md#pitch)

## Errors

- 403 history_not_in_plan — the fixture predates the history your plan covers
- 404 not_found — the fixture or at-bat id does not exist

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/at-bats/{atBatId}/pitches"
```

TypeScript:

```ts
const { data, meta } = await client.fixtures.pitches(id, atBatId);
```

Python:

```python
res = client.fixtures.pitches(id, at_bat_id)
```

Go:

```go
res, err := client.Fixtures.Pitches(ctx, id, atBatId)
```

CLI:

```bash
$ dsa fixtures pitches <id> <atBatId>
```

## Example response

```json
{ "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 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/fixtures/pitches/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
