Skip to content

Biographical Encyclopedia

Retrosheet maintains the authoritative biographical encyclopedia of all players, managers, coaches, and umpires who have appeared in Major League Baseball, including historical Negro Leagues participants.

The master dataset (biofile.zip containing biofile0.csv) provides 32 standardized, strongly-typed fields including vital records, debut and final appearance dates, physical attributes, cemetery records, and Hall of Fame status.


Python API Usage

import retrosheetpy as rs

# 1. Fetch biographical master into Polars
bio_df = rs.bio(backend="polars")

# Filter Hall of Fame players
hof_players = bio_df.filter(bio_df["hof"].is_not_null())
print(hof_players.select(["player_id", "use_name", "last_name", "debut_player", "hof"]))

# 2. Ingest into DuckDB
rs.to_duckdb("baseball.duckdb", datasets=["bio"])

# 3. Export to Parquet
rs.to_parquet("biofile.parquet", dataset="bio")

CLI Usage

# Download and cache biographical master
retrosheetpy download -s bio

# Export to Parquet or CSV
retrosheetpy export -s bio -f parquet -o biofile.parquet
retrosheetpy export -s bio -f csv -o biofile.csv

# Generate Snowflake SQL DDL
retrosheetpy ddl -s bio --dialect snowflake

PyArrow Schema (BIO_SCHEMA)

Column Name Arrow Type SQL Dialects Description
player_id pa.string() VARCHAR / STRING Primary Retrosheet identifier (e.g. aaroh101).
last_name pa.string() VARCHAR / STRING Legal last name.
use_name pa.string() VARCHAR / STRING Commonly known first name (e.g. Hank).
full_name pa.string() VARCHAR / STRING Complete legal full name.
birth_date pa.date32() DATE Birth date (YYYY-MM-DD).
birth_city pa.string() VARCHAR / STRING City of birth.
birth_state pa.string() VARCHAR / STRING State/province of birth.
birth_country pa.string() VARCHAR / STRING Country of birth.
death_date pa.date32() DATE Date of death (YYYY-MM-DD) if deceased.
death_city pa.string() VARCHAR / STRING City of death.
death_state pa.string() VARCHAR / STRING State/province of death.
death_country pa.string() VARCHAR / STRING Country of death.
cemetery pa.string() VARCHAR / STRING Cemetery or internment facility name.
cem_city pa.string() VARCHAR / STRING Cemetery city location.
cem_state pa.string() VARCHAR / STRING Cemetery state/province.
cem_country pa.string() VARCHAR / STRING Cemetery country.
cem_note pa.string() VARCHAR / STRING Grave location or internment notes.
birth_name pa.string() VARCHAR / STRING Name given at birth if different.
alt_name pa.string() VARCHAR / STRING Nicknames or alternative spellings.
debut_player pa.date32() DATE First Major League appearance as a player.
last_player pa.date32() DATE Final Major League appearance as a player.
debut_coach pa.date32() DATE First appearance as an MLB coach.
last_coach pa.date32() DATE Final appearance as an MLB coach.
debut_manager pa.date32() DATE First appearance as an MLB manager.
last_manager pa.date32() DATE Final appearance as an MLB manager.
debut_umpire pa.date32() DATE First appearance as an MLB umpire.
last_umpire pa.date32() DATE Final appearance as an MLB umpire.
bats pa.string() VARCHAR / STRING Batting hand (R, L, B).
throws pa.string() VARCHAR / STRING Throwing hand (R, L).
height_inches pa.int16() SMALLINT / INT64 Player height in inches (e.g. 74 for 6'2").
weight_lbs pa.int16() SMALLINT / INT64 Weight in pounds (e.g. 205).
hof pa.string() VARCHAR / STRING Hall of Fame induction year or indicator.