players

Get a player

get/v1/players/{player_id}

Request

  • Base URL: https://lumify.ai
  • URL: https://lumify.ai/v1/players/{player_id}
  • Auth: HTTP bearer

Path parameters

player_idinteger required

Response

Successful Response

idinteger nullable

Lumify player ID.

slugstring nullable

URL-safe unique slug.

full_namestring nullable

Display name.

first_namestring nullable
last_namestring nullable
sportstring nullable

Sport slug, e.g. mlb, tennis, nfl.

country_codestring nullable

ISO 3166-1 alpha-3 country code.

birthdatestring nullable

YYYY-MM-DD date of birth.

positionstring nullable

Roster position abbreviation when the sport has one (e.g. C, P, SS for MLB; QB, WR for NFL). Null for tennis and when not yet ingested.

handednessstring nullable

left | right | switch. Meaning is sport-specific (bats for MLB, shoots for NHL, playing hand for tennis). Null when unknown.

height_cminteger nullable

Height in centimetres. Null when not ingested.

weight_kgnumber nullable

Weight in kilograms. Null when not ingested.

current_team_idinteger nullable

Lumify team ID when the player is on a club roster. Null for tennis.

current_team_namestring nullable

Current team display name. Null for tennis.

is_activeboolean nullable

False when deactivated or retired.

retired_atstring nullable

YYYY-MM-DD retirement date when known.

image_urlstring nullable

Lumify media URL for the player headshot (https://lumify.ai/media/players/{sport}/{id}.{ext}). Null until the sport's headshot/enrichment job. Never a vendor CDN.

Changes

No recorded changes to this operation across all 1 revision of this API.