v

latestOpenAPI 3.1.02026-08-0810683186.9 KB

Baseball Bat Sessions

Ingest Bat Sessions

Create or update baseball batting sessions.

Send one or more hitter sessions with swing-level bat-tracking measurements. Stable source identifiers make retries idempotent. Set dryRun to validate and preview the import without database writes.

post/api/v1/baseball/bat-sessions

Headers

x-api-keystring nullable

Leaguestring nullable

Request body

seasonstring required

Season label, for example 2026.

seasonTypestring

Season type.

gameTierstring

Competition tier.

venuestring

Venue or source label.

speedUnit'kph' | 'mph'

Unit used by batSpeed and exitVelocity. Values are stored as mph.

distanceUnit'm' | 'ft'

Unit used by hitDistance. Values are stored as feet.

dryRunboolean

Validate and prepare the import without writing to the database.

Response

Successful Response

successboolean required

dryRunboolean required

warningsstring[]