--- title: "List pitches for MLB" method: GET path: "/api/v1/mlb/pitches" tags: ["MLB"] --- # List pitches for MLB `GET /api/v1/mlb/pitches` ## Request - Base URL: `https://api.stat-api.com` - URL: `https://api.stat-api.com/api/v1/mlb/pitches` - Auth: HTTP bearer ## Query parameters - `game_id` integer - `limit` integer - `from_id` integer - `format` 'json' | 'csv' ## Response `200` pitches rows matching the declared filter set. - MLBPitchesListResponse - `has_more` boolean, required: True when a full page came back, so more rows can exist. - `limit` integer, required: Page size used for this response. - `next_from_id` integer, nullable, required: Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`. - `pitches` MLBPitches[], required - `air_out` boolean, required: Whether this pitch resulted in an air out - `at_bat_id` integer, required - `ball` boolean, required - `barrel` boolean, nullable: Optimal combination of exit velocity and launch angle - `batter_id` integer, required - `break_angle` number, float, nullable - `break_length` number, float, nullable - `break_y` number, float, nullable - `breaking_ball` boolean, nullable: Breaking ball (curveball, slider, knuckleball) - `call` string, required - `catchers_interference` boolean, required: Whether this pitch resulted in catchers interference - `chase` boolean, nullable: Whether batter swung at pitch outside zone - `double` boolean, required: Whether this pitch resulted in a double - `effective_speed` number, float, nullable: Perceived speed to batter (mph) - `expected_batting_avg` number, double, nullable: xBA based on exit velocity and launch angle - `expected_woba` number, double, nullable: xwOBA based on exit velocity and launch angle - `extension` number, float, nullable - `fastball` boolean, nullable: Fastball variant (4-seam, 2-seam, sinker, cutter) - `flare_burner` boolean, nullable: Launch angle 10-25 AND exit velocity < 95 - `fly_out` boolean, required: Whether this pitch resulted in a fly out - `game_id` integer, required - `ground_into_double_play` boolean, required: Whether this pitch resulted in grounding into double play - `ground_into_triple_play` boolean, required: Whether this pitch resulted in grounding into triple play - `ground_out` boolean, required: Whether this pitch resulted in a ground out - `hard_hit` boolean, nullable: Exit velocity >= 95 MPH - `hit_by_pitch` boolean, required: Whether this pitch resulted in hit by pitch - `hit_coord_x` number, float, nullable: Hit coordinate X (feet from home plate) - `hit_coord_y` number, float, nullable: Hit coordinate Y (feet from home plate) - `hit_distance` integer, nullable: Distance of batted ball (feet) - `hit_exit_velocity` number, float, nullable: Exit velocity of batted ball (mph) - `hit_launch_angle` number, float, nullable: Launch angle of batted ball (degrees) - `home_run` boolean, required: Whether this pitch resulted in a home run - `id` integer, required: Primary Key - `in_play` boolean, required - `in_strike_zone` boolean, nullable: Whether pitch was in the strike zone - `intentional_walk` boolean, required: Whether this pitch resulted in an intentional walk - `launch_speed_angle_zone` integer, nullable: 1=Weak, 2=Topped, 3=Under, 4=Flare/Burner, 5=Solid, 6=Barrel - `line_out` boolean, required: Whether this pitch resulted in a line out - `offspeed` boolean, nullable: Offspeed pitch (changeup, splitter, forkball) - `pitch_number` integer, required - `pitch_speed` number, float, nullable - `pitch_type` string, nullable - `pitch_x` number, float, nullable - `pitch_y` number, float, nullable - `pitch_z` number, float, nullable - `pitch_zone` integer, nullable - `pitcher_id` integer, required - `plate_x` number, float, nullable - `plate_z` number, float, nullable - `play_id` integer, required - `pop_out` boolean, required: Whether this pitch resulted in a pop out - `release_speed` number, float, nullable: Speed at release point (mph) - `result` string, required - `sacrifice_fly` boolean, required: Whether this pitch resulted in a sacrifice fly - `sacrifice_hit` boolean, required: Whether this pitch resulted in a sacrifice bunt - `single` boolean, required: Whether this pitch resulted in a single - `solid_contact` boolean, nullable: Launch angle 20-25 AND exit velocity 95-100 - `spin_axis` number, float, nullable: Spin axis (degrees) - `spin_direction` number, float, nullable - `spin_rate` number, float, nullable - `spray_angle` number, float, nullable: Horizontal angle from center field (degrees) - `start_time` string, date-time, nullable: Wall-clock time of the pitch, as the league records it - `statcast_quality_score` number, double, nullable: Statcast data quality score (0.0-1.0) - `strike` boolean, required - `strike_zone_bottom` number, float, nullable - `strike_zone_top` number, float, nullable - `strikeout` boolean, required: Whether this pitch resulted in a strikeout - `sweet_spot` boolean, nullable: Launch angle between 8-32 degrees - `topped` boolean, nullable: Launch angle < 10 AND exit velocity < 90 - `tracking_confidence` number, double, nullable: Confidence in tracking data accuracy - `triple` boolean, required: Whether this pitch resulted in a triple - `under` boolean, nullable: Launch angle less than 10 degrees - `walk` boolean, required: Whether this pitch resulted in a walk ## Other responses - `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations. --- [API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/23b66b957723?raw)