Teams, Players & Rosters
Extended venue
Additive baseball enrichment. Existing endpoints and caches are unchanged. Private, no-store; BASEBALL_EXTENSIONS_ENABLED=false disables this route. Requires stats entitlement. Source observations may be absent until enrichment is deployed/backfilled. Season statistics are exact-scope, regular season by default; postseason/preseason can be requested but are not synthesized. Cursor ordering uses canonical extension ID, not event occurrence order. Multiple producers remain separate; never sum duplicate official totals and team stints.
https://api.sportquanta.com/v1/npb/venues/{id}/extendedReference context: NPB.
Overview · Response conventions
Authorizations
AuthorizationstringheaderrequiredSend a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
idstringrequiredQuery Parameters
seasonintegerdefault:0Required range: 0 <= x, x <= 2100
game_typeenum<string>Available options: regular, postseason, preseason, unknown
producerstringlimitintegerdefault:50Required range: 1 <= x, x <= 100
cursorstringResponse
application/jsonIndependent observed enrichment with explicit coverage; missing data never implies zero.
Query validation failed. Depending on the handler, invalid_query_parameter is returned with HTTP 400 or 422. Pre-read validation is non-billable.
Missing or invalid bearer API token.
Access is forbidden: the token lacks api.read scope, the plan lacks an endpoint/bookmaker capability, or configured billing access is inactive. Inspect error.code and details.feature when present.
The league is unsupported, the endpoint is not available for that sport, or the requested data has not been ingested. Inspect error.code.
Token validation or an internal handler failed. Token-store failures use api_token_lookup_failed; unsupported internal sport dispatch can use data_layer_unavailable.
The data layer (Mongo / ClickHouse / Redis cache) is temporarily unreachable. The server attempted the lookup; it failed. Retry with backoff. Per the spec's order of evaluation, this DOES consume monthly quota — the request reached step 6.
dataobjectdata.observationsobject[]requireddata.observations.canonical_idstringrequireddata.observations.subject_idstringrequireddata.observations.subject_typeenum<string>requiredAvailable options: game, events, player, team, venue, player_season, team_season, standings, transaction, umpire
data.observations.seasonnumberrequireddata.observations.game_typeenum<string>requiredAvailable options: regular, postseason, preseason, unknown
data.observations.producerstringrequireddata.observations.schema_versionnumberrequireddata.observations.observed_atstringrequireddata.observations.source_urlstring | nullrequireddata.observations.dataobjectrequiredProducer-specific sections are optional. Interpret source code fields only with the corresponding source definition. Current profiles, season rows, transactions and game events have different scopes. Unknown values stay null; absent sections are not zero.
data.observations.data.coverageobjectAvailability, source traversal, event reconciliation and population completeness are separate checks.
data.observations.data.coverage.availablebooleandata.observations.data.coverage.completeboolean | nulldata.observations.data.coverage.reasonstringdata.observations.data.coverage.scopestringdata.observations.data.coverage.source_rowsintegerdata.observations.data.coverage.unmapped_rowsintegerdata.observations.data.coverage.source_pages_completebooleandata.observations.data.coverage.source_table_completebooleandata.observations.data.coverage.sequence_completebooleandata.observations.data.coverage.score_reconciledbooleandata.observations.data.coverage.derived_situations_availablebooleandata.observations.data.coverage.finalbooleandata.observations.data.coverage.plate_appearancesintegerdata.observations.data.rowsobject[]data.observations.data.rows.rolestringdata.observations.data.rows.stat_typestringdata.observations.data.rows.team_idstring | nulldata.observations.data.rows.source_team_idstring | nulldata.observations.data.rows.source_team_codestring | nulldata.observations.data.rows.positionstring | nulldata.observations.data.rows.identity_methodstringdata.observations.data.rows.statisticsobjectSource, role and statistical scope must be retained with these values. Source_statistics contains provider-native columns; exact definitions may remain unverified.
data.observations.data.rows.statistics.rolestringdata.observations.data.rows.statistics.reported_countsobjectOnly mapped source fields appear. A missing field is unavailable, not zero. Pitching hits are hits allowed. Fielding stolen_bases_allowed/runners_caught_stealing are defensive counts. outs_recorded is integer outs.
data.observations.data.rows.statistics.reported_counts.gamesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.startsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.plate_appearancesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.at_batsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.hitsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.doublesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.triplesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.home_runsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.runsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.rbiinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.walksinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.intentional_walksinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.hit_by_pitchinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.strikeoutsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.stolen_basesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.caught_stealinginteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.stolen_bases_allowedinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.runners_caught_stealinginteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.sacrifice_fliesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.sacrifice_buntsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.putoutsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.assistsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.errorsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.chancesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.double_playsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.triple_playsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.passed_ballsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.pickoffsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.earned_runsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.batters_facedinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.pitchesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.ballsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.strikesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.winsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.lossesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.savesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.save_opportunitiesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.holdsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.blown_savesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.complete_gamesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.shutoutsinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.wild_pitchesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.balksinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.inherited_runnersinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.inherited_runners_scoredinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.left_on_baseinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.gidpinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.gidp_opportunitiesinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.reported_counts.outs_recordedinteger | nullRequired range: 0 <= x
data.observations.data.rows.statistics.derivedobjectRole-specific derived metrics; missing prerequisites yield null. Pitching per-nine values use integer outs. No provider-reported percentages are averaged.
data.observations.data.rows.statistics.derived.singlesnumber | nulldata.observations.data.rows.statistics.derived.extra_base_hitsnumber | nulldata.observations.data.rows.statistics.derived.total_basesnumber | nulldata.observations.data.rows.statistics.derived.stolen_base_attemptsnumber | nulldata.observations.data.rows.statistics.derived.stolen_base_success_ratenumber | nulldata.observations.data.rows.statistics.derived.batting_averagenumber | nulldata.observations.data.rows.statistics.derived.on_base_percentagenumber | nulldata.observations.data.rows.statistics.derived.slugging_percentagenumber | nulldata.observations.data.rows.statistics.derived.opsnumber | nulldata.observations.data.rows.statistics.derived.inherited_runners_not_scorednumber | nulldata.observations.data.rows.statistics.derived.hits_per_ninenumber | nulldata.observations.data.rows.statistics.derived.home_runs_per_ninenumber | nulldata.observations.data.rows.statistics.derived.strikeouts_per_ninenumber | nulldata.observations.data.rows.statistics.derived.walks_per_ninenumber | nulldata.observations.data.rows.statistics.derived.strikeout_walk_rationumber | nulldata.observations.data.rows.statistics.derived.fielding_percentagenumber | nulldata.observations.data.rows.statistics.derived.calculation_methodstringdata.observations.data.rows.statistics.derived.percentage_scale"fraction"data.observations.data.rows.statistics.source_statisticsobjectdata.observations.data.player_rowsobject[]data.observations.data.player_rows.player_idstring | nulldata.observations.data.player_rows.source_namestringdata.observations.data.player_rows.positionstring | nulldata.observations.data.player_rows.statisticsobjectSource, role and statistical scope must be retained with these values. Source_statistics contains provider-native columns; exact definitions may remain unverified.
data.observations.data.player_rows.statistics.rolestringdata.observations.data.player_rows.statistics.reported_countsobjectOnly mapped source fields appear. A missing field is unavailable, not zero. Pitching hits are hits allowed. Fielding stolen_bases_allowed/runners_caught_stealing are defensive counts. outs_recorded is integer outs.
data.observations.data.player_rows.statistics.reported_counts.gamesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.startsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.plate_appearancesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.at_batsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.hitsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.doublesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.triplesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.home_runsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.runsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.rbiinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.walksinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.intentional_walksinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.hit_by_pitchinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.strikeoutsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.stolen_basesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.caught_stealinginteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.stolen_bases_allowedinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.runners_caught_stealinginteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.sacrifice_fliesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.sacrifice_buntsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.putoutsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.assistsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.errorsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.chancesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.double_playsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.triple_playsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.passed_ballsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.pickoffsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.earned_runsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.batters_facedinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.pitchesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.ballsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.strikesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.winsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.lossesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.savesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.save_opportunitiesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.holdsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.blown_savesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.complete_gamesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.shutoutsinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.wild_pitchesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.balksinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.inherited_runnersinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.inherited_runners_scoredinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.left_on_baseinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.gidpinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.gidp_opportunitiesinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.reported_counts.outs_recordedinteger | nullRequired range: 0 <= x
data.observations.data.player_rows.statistics.derivedobjectRole-specific derived metrics; missing prerequisites yield null. Pitching per-nine values use integer outs. No provider-reported percentages are averaged.
data.observations.data.player_rows.statistics.derived.singlesnumber | nulldata.observations.data.player_rows.statistics.derived.extra_base_hitsnumber | nulldata.observations.data.player_rows.statistics.derived.total_basesnumber | nulldata.observations.data.player_rows.statistics.derived.stolen_base_attemptsnumber | nulldata.observations.data.player_rows.statistics.derived.stolen_base_success_ratenumber | nulldata.observations.data.player_rows.statistics.derived.batting_averagenumber | nulldata.observations.data.player_rows.statistics.derived.on_base_percentagenumber | nulldata.observations.data.player_rows.statistics.derived.slugging_percentagenumber | nulldata.observations.data.player_rows.statistics.derived.opsnumber | nulldata.observations.data.player_rows.statistics.derived.inherited_runners_not_scorednumber | nulldata.observations.data.player_rows.statistics.derived.hits_per_ninenumber | nulldata.observations.data.player_rows.statistics.derived.home_runs_per_ninenumber | nulldata.observations.data.player_rows.statistics.derived.strikeouts_per_ninenumber | nulldata.observations.data.player_rows.statistics.derived.walks_per_ninenumber | nulldata.observations.data.player_rows.statistics.derived.strikeout_walk_rationumber | nulldata.observations.data.player_rows.statistics.derived.fielding_percentagenumber | nulldata.observations.data.player_rows.statistics.derived.calculation_methodstringdata.observations.data.player_rows.statistics.derived.percentage_scale"fraction"data.observations.data.player_rows.statistics.source_statisticsobjectdata.observations.data.teamsobject[]data.observations.data.officialsobject[]data.observations.data.coachesobject[]data.observations.data.notesobject[]data.observations.data.game_infoobjectdata.observations.data.datetimeobjectdata.observations.data.competitionobjectdata.observations.data.weatherobjectdata.observations.data.time_tbdboolean | nulldata.observations.data.broadcast_namestring | nulldata.observations.data.broadcastsobject[]data.observations.data.home_split_squadboolean | nulldata.observations.data.away_split_squadboolean | nulldata.observations.data.scheduled_inningsinteger | nulldata.observations.data.local_start_timestring | nulldata.observations.data.local_end_timestring | nulldata.observations.data.timezonestringdata.observations.data.playsobject[]data.observations.data.plays.source_indexinteger | nulldata.observations.data.plays.inninginteger | nulldata.observations.data.plays.halfstring | nulldata.observations.data.plays.batterobjectUnresolved or ambiguous canonical identity remains null.
data.observations.data.plays.batter.canonical_idstring | nulldata.observations.data.plays.batter.source_idstring | nulldata.observations.data.plays.batter.namestring | nulldata.observations.data.plays.pitcherobjectUnresolved or ambiguous canonical identity remains null.
data.observations.data.plays.pitcher.canonical_idstring | nulldata.observations.data.plays.pitcher.source_idstring | nulldata.observations.data.plays.pitcher.namestring | nulldata.observations.data.plays.event_typestring | nulldata.observations.data.plays.descriptionstring | nulldata.observations.data.plays.rbinumber | nulldata.observations.data.plays.is_completeboolean | nulldata.observations.data.plays.is_scoring_playboolean | nulldata.observations.data.plays.started_atstring | nulldata.observations.data.plays.ended_atstring | nulldata.observations.data.plays.outs_beforenumber | nulldata.observations.data.plays.outs_afternumber | nulldata.observations.data.plays.home_score_beforenumber | nulldata.observations.data.plays.away_score_beforenumber | nulldata.observations.data.plays.home_score_afternumber | nulldata.observations.data.plays.away_score_afternumber | nulldata.observations.data.plays.runnersobject[]data.observations.data.plays.eventsobject[]data.observations.data.plays.events.source_indexinteger | nulldata.observations.data.plays.events.source_event_idstring | nulldata.observations.data.plays.events.typestring | nulldata.observations.data.plays.events.is_pitchboolean | nulldata.observations.data.plays.events.pitch_numberinteger | nulldata.observations.data.plays.events.started_atstring | nulldata.observations.data.plays.events.ended_atstring | nulldata.observations.data.plays.events.playerobjectUnresolved or ambiguous canonical identity remains null.
data.observations.data.plays.events.player.canonical_idstring | nulldata.observations.data.plays.events.player.source_idstring | nulldata.observations.data.plays.events.player.namestring | nulldata.observations.data.plays.events.replaced_playerobjectUnresolved or ambiguous canonical identity remains null.
data.observations.data.plays.events.replaced_player.canonical_idstring | nulldata.observations.data.plays.events.replaced_player.source_idstring | nulldata.observations.data.plays.events.replaced_player.namestring | nulldata.observations.data.plays.events.countobjectdata.observations.data.plays.events.detailsobjectdata.observations.data.plays.events.positionobjectdata.observations.data.plays.events.pitch_dataobject | nulldata.observations.data.plays.events.hit_dataobject | nulldata.observations.data.eventsobject[]data.observations.data.source_eventsobject[]data.observations.data.source_header_inningnumber | nulldata.observations.data.source_orderstringdata.observations.data.measurement_definitionsobjectdata.observations.data.namestring | nulldata.observations.data.birth_citystring | nulldata.observations.data.birth_statestring | nulldata.observations.data.birth_countrystring | nulldata.observations.data.birthplace_textstring | nulldata.observations.data.educationobject | nulldata.observations.data.draft_yearnumber | nulldata.observations.data.activeboolean | nulldata.observations.data.career_textstring | nulldata.observations.data.draft_textstring | nulldata.observations.data.reported_birth_datestring | nulldata.observations.data.reported_positionstring | nulldata.observations.data.awardsobject[]data.observations.data.draftobjectdata.observations.data.draft_picksobject[]data.observations.data.salary_observationobjectdata.observations.data.signing_bonus_observationobjectdata.observations.data.locationstring | nulldata.observations.data.leagueobjectdata.observations.data.divisionobjectdata.observations.data.venueobjectdata.observations.data.field_infoobjectdata.observations.data.itemsobject[]data.observations.data.source_transaction_idstringdata.observations.data.player_idstring | nulldata.observations.data.source_player_idstring | nulldata.observations.data.from_team_idstring | nulldata.observations.data.to_team_idstring | nulldata.observations.data.datestring | nulldata.observations.data.effective_datestring | nulldata.observations.data.resolution_datestring | nulldata.observations.data.type_codestring | nulldata.observations.data.type_descriptionstring | nulldata.observations.data.descriptionstring | nulldata.next_cursorstring | nullrequireddata.coverageobjectrequiredmetaobjecterrorobjectrequirederror.codestringrequiredStable machine-readable error code.
error.messagestringrequiredUser-facing error summary.
error.detailsanyOptional error details.