MLB

Get a single pitche by id

get/api/v1/mlb/pitches/{id}

Request

  • Base URL: https://api.stat-api.com
  • URL: https://api.stat-api.com/api/v1/mlb/pitches/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Primary Key

Primary key (id) of the pitches row.

Response

Single pitches row.

air_outboolean required

Whether this pitch resulted in an air out

at_bat_idinteger required
ballboolean required
barrelboolean nullable

Optimal combination of exit velocity and launch angle

batter_idinteger required
break_anglenumber float nullable
break_lengthnumber float nullable
break_ynumber float nullable
breaking_ballboolean nullable

Breaking ball (curveball, slider, knuckleball)

callstring required
catchers_interferenceboolean required

Whether this pitch resulted in catchers interference

chaseboolean nullable

Whether batter swung at pitch outside zone

doubleboolean required

Whether this pitch resulted in a double

effective_speednumber float nullable

Perceived speed to batter (mph)

expected_batting_avgnumber double nullable

xBA based on exit velocity and launch angle

expected_wobanumber double nullable

xwOBA based on exit velocity and launch angle

extensionnumber float nullable
fastballboolean nullable

Fastball variant (4-seam, 2-seam, sinker, cutter)

flare_burnerboolean nullable

Launch angle 10-25 AND exit velocity < 95

fly_outboolean required

Whether this pitch resulted in a fly out

game_idinteger required
ground_into_double_playboolean required

Whether this pitch resulted in grounding into double play

ground_into_triple_playboolean required

Whether this pitch resulted in grounding into triple play

ground_outboolean required

Whether this pitch resulted in a ground out

hard_hitboolean nullable

Exit velocity >= 95 MPH

hit_by_pitchboolean required

Whether this pitch resulted in hit by pitch

hit_coord_xnumber float nullable

Hit coordinate X (feet from home plate)

hit_coord_ynumber float nullable

Hit coordinate Y (feet from home plate)

hit_distanceinteger nullable

Distance of batted ball (feet)

hit_exit_velocitynumber float nullable

Exit velocity of batted ball (mph)

hit_launch_anglenumber float nullable

Launch angle of batted ball (degrees)

home_runboolean required

Whether this pitch resulted in a home run

idinteger required

Primary Key

in_playboolean required
in_strike_zoneboolean nullable

Whether pitch was in the strike zone

intentional_walkboolean required

Whether this pitch resulted in an intentional walk

launch_speed_angle_zoneinteger nullable

1=Weak, 2=Topped, 3=Under, 4=Flare/Burner, 5=Solid, 6=Barrel

line_outboolean required

Whether this pitch resulted in a line out

offspeedboolean nullable

Offspeed pitch (changeup, splitter, forkball)

pitch_numberinteger required
pitch_speednumber float nullable
pitch_typestring nullable
pitch_xnumber float nullable
pitch_ynumber float nullable
pitch_znumber float nullable
pitch_zoneinteger nullable
pitcher_idinteger required
plate_xnumber float nullable
plate_znumber float nullable
play_idinteger required
pop_outboolean required

Whether this pitch resulted in a pop out

release_speednumber float nullable

Speed at release point (mph)

resultstring required
sacrifice_flyboolean required

Whether this pitch resulted in a sacrifice fly

sacrifice_hitboolean required

Whether this pitch resulted in a sacrifice bunt

singleboolean required

Whether this pitch resulted in a single

solid_contactboolean nullable

Launch angle 20-25 AND exit velocity 95-100

spin_axisnumber float nullable

Spin axis (degrees)

spin_directionnumber float nullable
spin_ratenumber float nullable
spray_anglenumber float nullable

Horizontal angle from center field (degrees)

start_timestring date-time nullable

Wall-clock time of the pitch, as the league records it

statcast_quality_scorenumber double nullable

Statcast data quality score (0.0-1.0)

strikeboolean required
strike_zone_bottomnumber float nullable
strike_zone_topnumber float nullable
strikeoutboolean required

Whether this pitch resulted in a strikeout

sweet_spotboolean nullable

Launch angle between 8-32 degrees

toppedboolean nullable

Launch angle < 10 AND exit velocity < 90

tracking_confidencenumber double nullable

Confidence in tracking data accuracy

tripleboolean required

Whether this pitch resulted in a triple

underboolean nullable

Launch angle less than 10 degrees

walkboolean required

Whether this pitch resulted in a walk

Changes

No recorded changes to this operation across all 2 revisions of this API.