SofaScore event at-bat pitches API

Endpoint facts

Method

GET

API path

/sofascore/event-at-bat-pitches

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.eventAtBatPitchesResponseDoc

How this endpoint behaves

Returns every pitch of one baseball at-bat from SofaScore, in pitch order, with tracking data.

Query parameters:

• id: required. Numeric SofaScore baseball event (match) id, e.g. 17199139.
• at_bat_id: required. Numeric at-bat id taken from sofascore/event-at-bats for the same event, e.g. 2595879.

Notable response behavior:

• Each pitch has the count after it (balls, strikes, outs, pitch_count), a pitch_type code with pitch_code and pitch_description (for example FA, FF, Four-Seam Fastball), pitch_speed in kilometres per hour, pitch_zone, pitch_x/pitch_y plate coordinates, the mlb_x/mlb_y/mlb_zone league tracking values, strike_zone_top and strike_zone_bottom, pitcher_hand and hitter_hand, and the score (home_team_runs, away_team_runs).
• outcome is SofaScore's result code for the pitch. Values seen: bB (ball), kKL (strike looking), kKS (strike swinging), kF (foul), aS (hit into play, a single in the sample), oFO (fly out), oLO (line out), oGO (ground out). Other codes are passed through unchanged.
• at_bat_over is true on the pitch that ends the at-bat. For a ball in play hit_type (GB ground ball, LD line drive, FB fly ball), hit_trajectory, hit_hardness, hit_location and hit_x/hit_y are present. runners lists baserunner moves (starting_base 0 is the batter's box, 1 to 3 are the bases) and fielders lists putout and assist credits.
• Returns 404 when SofaScore has no pitches for the at-bat, which includes an at-bat id that does not belong to the event.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 17199139,
    "at_bat_id": 2595879,
    "source_url": "https://api.sofascore.com/api/v1/event/17199139/atbat/2595879/pitches",
    "fetched_at": "2026-10-07T17:00:00Z",
    "pitcher": {
      "id": 960737,
      "name": "Chris Sale",
      "short_name": "C. Sale",
      "slug": "sale-chris",
      "position": "SP",
      "jersey_number": "51"
    },
    "hitter": {
      "id": 960736,
      "name": "Mookie Betts",
      "short_name": "M. Betts",
      "slug": "betts-mookie",
      "position": "SS",
      "jersey_number": "50"
    },
    "count": 7,
    "pitches": [
      {
        "id": 10178342,
        "sequence": 3,
        "inning": 1,
        "inning_half": "top",
        "type": "pitch",
        "outcome": "kKL",
        "status": "official",
        "start_time": "2026-10-06T22:11:49Z",
        "end_time": "2026-10-06T22:12:04Z",
        "balls": 0,
        "strikes": 1,
        "outs": 0,
        "pitch_count": 1,
        "pitch_type": "FA",
        "pitch_code": "FF",
        "pitch_description": "Four-Seam Fastball",
        "pitch_speed": 158.04,
        "pitch_zone": 9,
        "pitcher_hand": "L",
        "hitter_hand": "R",
        "pitch_x": 76,
        "pitch_y": -47,
        "mlb_x": 137.94,
        "mlb_y": 184.98,
        "mlb_zone": 7,
        "strike_zone_top": 3.096,
        "strike_zone_bottom": 1.563,
        "home_team_runs": 0,
        "away_team_runs": 0,
        "at_bat_over": false,
        "hit": false,
        "bunt": false,
        "wild_pitch": false,
        "passed_ball": false,
        "double_play": false,
        "triple_play": false
      },
      "...",
      {
        "id": 10178348,
        "sequence": 9,
        "inning": 1,
        "inning_half": "top",
        "type": "pitch",
        "outcome": "aS",
        "status": "official",
        "start_time": "2026-10-06T22:13:41Z",
        "end_time": "2026-10-06T22:13:59Z",
        "balls": 3,
        "strikes": 2,
        "outs": 0,
        "pitch_count": 7,
        "pitch_type": "SL",
        "pitch_code": "SL",
        "pitch_description": "Slider",
        "pitch_speed": 128.59,
        "pitch_zone": 1,
        "pitcher_hand": "L",
        "hitter_hand": "R",
        "pitch_x": -41,
        "pitch_y": 52,
        "mlb_x": 105.6,
        "mlb_y": 165.82,
        "mlb_zone": 5,
        "strike_zone_top": 3.096,
        "strike_zone_bottom": 1.563,
        "home_team_runs": 0,
        "away_team_runs": 0,
        "at_bat_over": true,
        "hit": true,
        "bunt": false,
        "wild_pitch": false,
        "passed_ball": false,
        "double_play": false,
        "triple_play": false,
        "hit_type": "GB",
        "hit_trajectory": "ground_ball",
        "hit_hardness": "medium",
        "hit_location": "20",
        "hit_x": 164.06,
        "hit_y": 164.01,
        "runners": [
          {
            "player_id": 960736,
            "player_name": "Mookie Betts",
            "jersey_number": "50",
            "starting_base": 0,
            "ending_base": 1,
            "out": false,
            "outcome_code": "AD1"
          }
        ]
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/event-at-bat-pitches?at_bat_id=2595879&id=17199139

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

0.94 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/event-at-bat-pitches?at_bat_id=2595879&id=17199139

Items in pitches

7

Fields filled in every checked item

36

Fields empty in some or all items

4

Shared guides

Related