registry.prism.statsvine.com

A static JSON API serving enriched player metadata — names, birth dates, MLB roster affiliations, and more — built on top of the stable identifier mappings from PRISM Crosswalk. Where Crosswalk gives you IDs, Registry gives you the context to use them.

Build artifacts (exports in multiple formats): statsvine/prism-registry
Part of the PRISM ecosystem for sports player identity and data.

Currently covers MLB (~1,700+ players who appeared on a 40-man roster in 2025 or 2026, updated daily). NFL and NBA planned.

Products

Registry provides four datasets, each a superset of the previous:

player_ids          IDs + basic names (last, first, middle)
players_profile     Adds full names and birth data
players_mlb_profile Adds position, bat/throw hand, MLB debut date
players_mlb_roster  Adds current team and roster status

Endpoints

Look up by PRISM ID

https://registry.prism.statsvine.com/{sport}/{product}/{prism_id}.json

Look up by external ID

https://registry.prism.statsvine.com/{sport}/{product}/by_id/{source}/{source_id}.json

Supported source values: mlbam_id, bbref_id, fangraphs_ids, nfbc_id, sfbb_id, yahoo_id

Look up by team (players_mlb_roster only)

All players on a team:

https://registry.prism.statsvine.com/mlb/players_mlb_roster/by_team/{pivot}/{team}.json

All players on a team, grouped by roster status:

https://registry.prism.statsvine.com/mlb/players_mlb_roster/by_team_status/{pivot}/{team}.json

Supported pivot values: abbrev (e.g. LAD), mlb_id (e.g. 119)

Examples

Shohei Ohtani

https://registry.prism.statsvine.com/mlb/player_ids/pr2r5vzrqm.json
https://registry.prism.statsvine.com/mlb/players_mlb_roster/by_id/mlbam_id/660271.json
{
  "id": "pr2r5vzrqm",
  "ids": {
    "prism": "pr2r5vzrqm",
    "bbref": "ohtansh01",
    "fangraphs": "19755",
    "mlbam": "660271",
    "nfbc": "9810",
    "sfbb": "ohtansh01",
    "yahoo": "10835"
  },
  "names": {
    "firstLast": "Shohei Ohtani",
    "last": "Ohtani",
    "first": "Shohei"
  },
  "profile": {
    "birthDate": "1994-7-5",
    "birthCity": "Oshu",
    "birthCountry": "Japan",
    "batHand": "L",
    "fieldHand": "R",
    "debutDate": "2018-03-29"
  },
  "position": {
    "code": "Y",
    "abbreviation": "TWP"
  },
  "team": {
    "mlb_id": 119,
    "abbreviation": "LAD"
  },
  "status": {
    "code": "A",
    "description": "Active"
  }
}

LA Dodgers roster

https://registry.prism.statsvine.com/mlb/players_mlb_roster/by_team/abbrev/LAD.json
https://registry.prism.statsvine.com/mlb/players_mlb_roster/by_team_status/abbrev/LAD.json

Bulk downloads

Exports follow the pattern /exports/mlb/{product}/.

All four products are available in JSON, minified JSON, CSV, and NDJSON, plus by_id pivot files keyed by source.

player_ids


https://registry.prism.statsvine.com/exports/mlb/player_ids/player_ids.json
https://registry.prism.statsvine.com/exports/mlb/player_ids/player_ids.csv
https://registry.prism.statsvine.com/exports/mlb/player_ids/player_ids.ndjson
https://registry.prism.statsvine.com/exports/mlb/player_ids/by_id/mlbam_id.json

players_profile


https://registry.prism.statsvine.com/exports/mlb/players_profile/players_profile.json
https://registry.prism.statsvine.com/exports/mlb/players_profile/players_profile.csv
https://registry.prism.statsvine.com/exports/mlb/players_profile/players_profile.ndjson
https://registry.prism.statsvine.com/exports/mlb/players_profile/by_id/mlbam_id.json

players_mlb_profile


https://registry.prism.statsvine.com/exports/mlb/players_mlb_profile/players_mlb_profile.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_profile/players_mlb_profile.csv
https://registry.prism.statsvine.com/exports/mlb/players_mlb_profile/players_mlb_profile.ndjson
https://registry.prism.statsvine.com/exports/mlb/players_mlb_profile/by_id/mlbam_id.json

players_mlb_roster


https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/players_mlb_roster.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/players_mlb_roster.csv
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/players_mlb_roster.ndjson
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/by_id/mlbam_id.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/by_team/abbrev.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/by_team/mlb_id.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/by_team_status/abbrev.json
https://registry.prism.statsvine.com/exports/mlb/players_mlb_roster/by_team_status/mlb_id.json

All formats also available as .min.json.

Response shape

player_ids


id                   PRISM ID (always present)

ids.prism            PRISM ID (always present)
ids.mlbam            MLB Advanced Media ID (always present; most stable)
ids.bbref            Baseball Reference ID (always present)
ids.fangraphs        FanGraphs ID (always present; unstable for minor leaguers)
ids.nfbc             NFBC ID (may be absent)
ids.sfbb             SmartFantasyBaseball ID (may be absent)
ids.yahoo            Yahoo Fantasy ID (may be absent)

names.last           last name
names.first          first name
names.middle         middle name (may be absent)

players_profile (adds full names and birth data)


names.boxscore       boxscore display name
names.givenFirst     given first name
names.givenFirstMiddle given first + middle name
names.firstLast      "First Last"
names.lastFirst      "Last, First"
names.lastFirstInit  "Last, F"
names.givenFull      full given name

profile.birthDate    "YYYY-M-D" (may be absent)
profile.birthYear    birth year (may be absent)
profile.birthMonth   birth month (may be absent)
profile.birthDay     birth day (may be absent)
profile.birthCity    city (may be absent)
profile.birthState   state/province (may be absent)
profile.birthCountry country (may be absent)

players_mlb_profile (adds MLB-specific attributes)


profile.batHand      batting hand: L, R, or S (may be absent)
profile.fieldHand    throwing hand: L or R (may be absent)
profile.debutDate    MLB debut date "YYYY-MM-DD" (may be absent)

position.code        position code (e.g. "1" for pitcher, "Y" for two-way player)
position.abbreviation position abbreviation (e.g. "P", "CF", "TWP")

players_mlb_roster (adds team and roster status)


team.mlb_id          MLB team ID
team.abbreviation    team abbreviation (e.g. "LAD")

status.code          roster status code (A, D10, D15, D60, RM, null, ...)
status.description   human-readable status (e.g. "Active", "Injured 15-Day")