SofaScore event at-bats API

Endpoint facts

Method

GET

API path

/sofascore/event-at-bats

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.eventAtBatsResponseDoc

How this endpoint behaves

Query parameters:

• id: required. Numeric SofaScore event (match) id of a baseball match, e.g. 17199139 (an MLB game).

Notable response behavior:

• Each at-bat has an id, the inning and inning_half (top or bottom), the pitcher and hitter with their teams, and end_timestamp/end_time (when the at-bat finished, which equals the end of its last pitch).
• home_win_probability_start and away_win_probability_start are percentages before the at-bat, home_win_probability and away_win_probability after it.
• The at-bat list has no result; read the last pitch of the at-bat with sofascore/event-at-bat-pitches (at_bat_over, outcome, hit) for how it ended.
• An empty at_bats array is a valid response (a match that has not started its first at-bat). Returns 404 when SofaScore has no at-bat data for the match, which includes matches that have not started and sports other than baseball.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 17199139,
    "source_url": "https://api.sofascore.com/api/v1/event/17199139/at-bats",
    "fetched_at": "2026-10-07T17:00:00Z",
    "count": 73,
    "at_bats": [
      {
        "id": 2595879,
        "inning": 1,
        "inning_half": "top",
        "pitcher": {
          "id": 960737,
          "name": "Chris Sale",
          "short_name": "C. Sale",
          "slug": "sale-chris",
          "position": "SP",
          "jersey_number": "51"
        },
        "pitcher_team": {
          "id": 3656,
          "name": "Atlanta Braves",
          "short_name": "Braves",
          "slug": "atlanta-braves"
        },
        "hitter": {
          "id": 960736,
          "name": "Mookie Betts",
          "short_name": "M. Betts",
          "slug": "betts-mookie",
          "position": "SS",
          "jersey_number": "50"
        },
        "hitter_team": {
          "id": 3638,
          "name": "Los Angeles Dodgers",
          "short_name": "Dodgers",
          "slug": "los-angeles-dodgers"
        },
        "end_timestamp": 1791324839,
        "end_time": "2026-10-06T22:13:59Z",
        "home_win_probability_start": 51,
        "away_win_probability_start": 49,
        "home_win_probability": 47.9,
        "away_win_probability": 52.1
      },
      {
        "id": 2595880,
        "inning": 1,
        "inning_half": "top",
        "pitcher": {
          "id": 960737,
          "name": "Chris Sale",
          "short_name": "C. Sale",
          "slug": "sale-chris",
          "position": "SP",
          "jersey_number": "51"
        },
        "pitcher_team": {
          "id": 3656,
          "name": "Atlanta Braves",
          "short_name": "Braves",
          "slug": "atlanta-braves"
        },
        "hitter": {
          "id": 961444,
          "name": "Freddie Freeman",
          "short_name": "F. Freeman",
          "slug": "freeman-freddie",
          "position": "1B",
          "jersey_number": "5"
        },
        "hitter_team": {
          "id": 3638,
          "name": "Los Angeles Dodgers",
          "short_name": "Dodgers",
          "slug": "los-angeles-dodgers"
        },
        "end_timestamp": 1791324949,
        "end_time": "2026-10-06T22:15:49Z",
        "home_win_probability_start": 47.9,
        "away_win_probability_start": 52.1,
        "home_win_probability": 48.2,
        "away_win_probability": 51.8
      },
      "..."
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/event-at-bats?id=17199139

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

1.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/event-at-bats?id=17199139

Items in at_bats

73

Fields filled in every checked item

13

Shared guides

Related