Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

ID Handling

Intro to IDs

Our WNBA API features a number of unique identifiers. Some IDs are needed to request feeds, while others signify unique data.

IDs can be attributed to leagues, conferences, divisions, teams, venues, weeks, periods, quarters, coaches, managers, prospects, possessions, plays, in-game events, and many other variables.



ID Types

There are two primary ID types attributed to a variety of variables:

  • UUIDs (Universally Unique Identifiers)
  • SR IDs (Sportradar Identifiers)

Each directly identifies a given variable within the API, across multiple Sportradar APIs, or within data outside of Sportradar. The forms of IDs within the WNBA API are detailed below.


UUID IDs

These are the primary IDs we suggest to implement in your integration. They correlate to the League Specific APIs.

UUIDs follow a specific structure: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

You'll see these UUIDs for teams, players, games, seasons, and more.

<team id="5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4" name="Dream" alias="ATL" market="Atlanta"/>

SR IDs

These IDs correlate to our General Sport APIs, in this case the Global Basketball API. They can have a varying structure but always begin with sr: and end with a number.

<competitor id="sr:competitor:3440" name="Minnesota Lynx" short_name="Minnesota" abbreviation="MIN"/>

These IDs may appear as an id or a sr_id in various APIs.

<team
	id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" name="Lynx" market="Minnesota" alias="MIN" founded="1999" sr_id="sr:team:3440" owner="Glen Taylor, Alex Rodriguez, and Marc Lore" general_manager="Clare Duwelius" president="Carley Knox" mascot="Prowl" sponsor="Mayo Clinic" championships_won="4" championship_seasons="2011, 2013, 2015, 2017" conference_titles="4" retired_numbers="13, 23, 32, 33, 34" playoff_appearances="15" reference="1611661324">
	<venue id="7aed802e-3562-5b73-af1b-3859529f9b95" name="Target Center" capacity="19356" address="600 First Avenue North" city="Minneapolis" state="MN" zip="55403" country="USA" sr_id="sr:venue:6930">

🏀

Important Note

The sr_id is an optional value in the WNBA API and it’s strongly encouraged to utilize the UUIDs as your primary key. If you are integrating with the Global Basketball API or any of our Odds APIs, the sr_ids will be needed.

You can also use the mapping endpoints found in the Global Basketball API to get the mapping for each UUID to SR ID.



IDs in other SR Products


NCAA Women's Basketball

Most WNBA Players have previous experience in NCAA Women's Basketball, and thus have profiles and IDs within the NCAA Women's Basketball API. However, these unique IDs do not transfer to the WNBA API.

Drafted players are added to their WNBA teams within a few days after the WNBA Draft. Any undrafted free agents will also be added when those signings are announced. All of these player IDs will be separate across APIs.

🏀

WNBA Draft

At this time, there are currently no draft endpoints available for the WNBA, unlike those provided for the NBA.

You may also leverage the Mapping Feeds within the Global Basketball API should you need to link Sportradar IDs. These Mapping feeds provide id and sr_id links for teams, players, games, and seasons.

<mapping external_id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3420"/>
<mapping external_id="583ec7cd-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3419"/>
<mapping external_id="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3418"/>
<mapping external_id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3417"/>
<mapping external_id="583ecfa8-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3416"/>
<mapping external_id="7a30c43d-a206-476d-b5b2-75b419445ae9" id="sr:player:1176252"/>
<mapping external_id="20690402-3651-4ad5-8637-2cb1081bbb06" id="sr:player:2859809"/>
<mapping external_id="4d98d238-6a96-4770-ac25-3cec68b4f90c" id="sr:player:2859775"/>
<mapping external_id="01990f34-37fa-40c5-83ae-bd4da18a6901" id="sr:player:2859773"/>
<mapping external_id="2ee308da-2d15-42af-9e0d-7a4b211d07dd" id="sr:player:2859771"/>
<mapping external_id="e6d5aefa-59ef-49af-8fc2-bc27dc07ca99" id="sr:sport_event:53286421"/>
<mapping external_id="fdfc9371-22d3-4c8e-b95c-50b847a29505" id="sr:sport_event:53286415"/>
<mapping external_id="c12abfc2-ea49-49ad-a8bf-a26abed68c27" id="sr:sport_event:53336599"/>
<mapping external_id="35d392a6-d9b6-4225-97dd-c6e72b47c0d9" id="sr:sport_event:52864745"/>
<mapping external_id="8cbdc7e2-f9cb-4b89-92a4-05bcd57169d6" id="sr:sport_event:52866623"/>
<mapping external_id="a871223e-1e70-419e-8697-c0c1c010a7a9" id="sr:season:105257"/>
<mapping external_id="3dcf4c11-e7f8-4996-a34d-49069d14d465" id="sr:season:104315"/>
<mapping external_id="6d242a1f-93d0-48e4-96c0-45ff92ba607e" id="sr:season:105255"/>
<mapping external_id="7aa53f56-bde6-441f-966b-161ecd993de5" id="sr:season:104319"/>
<mapping external_id="db004e22-7ed4-4316-8302-79454224f49d" id="sr:season:112470"/>

Global Basketball

The Global Basketball API covers WNBA data at a much lower tier, and is based on the sr_id system, with IDs that look like: sr:competitor:3440 or sr:sport_event:54679333.

Make use of the Mapping Feeds within Global Basketball should you need to link between APIs. These feeds provide id and sr_id links for teams, players, games, and seasons.

<mapping external_id="583ec87d-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3420"/>
<mapping external_id="583ec7cd-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3419"/>
<mapping external_id="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3418"/>
<mapping external_id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3417"/>
<mapping external_id="583ecfa8-fb46-11e1-82cb-f4ce4684ea4c" id="sr:competitor:3416"/>
<mapping external_id="7a30c43d-a206-476d-b5b2-75b419445ae9" id="sr:player:1176252"/>
<mapping external_id="20690402-3651-4ad5-8637-2cb1081bbb06" id="sr:player:2859809"/>
<mapping external_id="4d98d238-6a96-4770-ac25-3cec68b4f90c" id="sr:player:2859775"/>
<mapping external_id="01990f34-37fa-40c5-83ae-bd4da18a6901" id="sr:player:2859773"/>
<mapping external_id="2ee308da-2d15-42af-9e0d-7a4b211d07dd" id="sr:player:2859771"/>
<mapping external_id="e6d5aefa-59ef-49af-8fc2-bc27dc07ca99" id="sr:sport_event:53286421"/>
<mapping external_id="fdfc9371-22d3-4c8e-b95c-50b847a29505" id="sr:sport_event:53286415"/>
<mapping external_id="c12abfc2-ea49-49ad-a8bf-a26abed68c27" id="sr:sport_event:53336599"/>
<mapping external_id="35d392a6-d9b6-4225-97dd-c6e72b47c0d9" id="sr:sport_event:52864745"/>
<mapping external_id="8cbdc7e2-f9cb-4b89-92a4-05bcd57169d6" id="sr:sport_event:52866623"/>
<mapping external_id="a871223e-1e70-419e-8697-c0c1c010a7a9" id="sr:season:105257"/>
<mapping external_id="3dcf4c11-e7f8-4996-a34d-49069d14d465" id="sr:season:104315"/>
<mapping external_id="6d242a1f-93d0-48e4-96c0-45ff92ba607e" id="sr:season:105255"/>
<mapping external_id="7aa53f56-bde6-441f-966b-161ecd993de5" id="sr:season:104319"/>
<mapping external_id="db004e22-7ed4-4316-8302-79454224f49d" id="sr:season:112470"/>

🗝️

Access

Please note that you will need access to the Global Basketball API in your account to make use of these endpoints.


Images & Editorial

Our Images and Editorial APIs include both UUID and SR IDs within image and article entries (under entity_id). This allows you to sync player, team, and game IDs to this content.

<asset id="01daa5de-5ee9-4c76-9e8b-455f1bf4d845" created="2023-05-16T17:46:09+00:00" updated="2024-02-28T08:08:23+00:00" player_id="29c9d387-8f15-4032-8a6f-5b4200cd2484" posed="true">
	<title>
		<![CDATA[Kylee Shook]]>
	</title>
	<description>
		<![CDATA[PHOENIX, AZ - MAY 3: Kylee Shook #26 of the Phoenix Mercury poses for a head shot during WNBA Media Day at Footprint Center on May 3, 2023 in Phoenix, Arizona. NOTE TO USER: User expressly acknowledges and agrees that, by downloading and or using this photograph, user is consenting to the terms and conditions of the Getty Images License Agreement.  Mandatory Copyright Notice: Copyright 2023 NBAE (Photo by Kate Frese/NBAE via Getty Images)]]>
	</description>
	<copyright>Getty</copyright>
	<links>
		<link width="2400" height="1608" href="/headshots/players/01daa5de-5ee9-4c76-9e8b-455f1bf4d845/original.jpg"/>
		<link width="205" height="205" href="/headshots/players/01daa5de-5ee9-4c76-9e8b-455f1bf4d845/205x205-crop.jpg"/>
		<link width="90" height="90" href="/headshots/players/01daa5de-5ee9-4c76-9e8b-455f1bf4d845/90x90-crop.jpg"/>
		<link width="250" height="250" href="/headshots/players/01daa5de-5ee9-4c76-9e8b-455f1bf4d845/250x250-crop.jpg"/>
		<link width="250" height="168" href="/headshots/players/01daa5de-5ee9-4c76-9e8b-455f1bf4d845/250w-resize.jpg"/>
	</links>
	<refs>
		<ref name="Shook, Kylee" type="profile" sport="wnba" sportradar_id="29c9d387-8f15-4032-8a6f-5b4200cd2484" primary="true">
			<entity_id origin="SD" id="29c9d387-8f15-4032-8a6f-5b4200cd2484" sport="wnba"/>
		</ref>
		<ref name="Phoenix Mercury" type="organization" sport="wnba" sportradar_id="0699edf3-5993-4182-b9b4-ec935cbd4fcc">
			<entity_id origin="SR" id="3444" sport="wnba"/>
			<entity_id origin="SD" id="0699edf3-5993-4182-b9b4-ec935cbd4fcc" sport="wnba"/>
		</ref>
	</refs>
	<provider name="getty">
		<provider_item_id>1252579278</provider_item_id>
		<original_publish>2023-05-02T00:00:00+00:00</original_publish>
	</provider>
</asset>
<asset id="00c2c640-3ab9-4117-a359-8938fd9a9be1" created="2023-05-19T17:12:11+00:00" updated="2024-03-03T13:56:23+00:00" player_id="84b8f0b9-a568-4b36-9ca0-d0b9b532eef1" posed="true">
	<title>
		<![CDATA[Ashley Joens]]>
	</title>
	<description>
		<![CDATA[ARLINGTON, TX - MAY 9: Ashley Joens #1 of the Dallas Wings poses for a head shot during WNBA Media Day at College Park Center on May 9, 2022 in Arlington, Texas. NOTE TO USER: User expressly acknowledges and agrees that, by downloading and or using this photograph, User is consenting to the terms and conditions of the Getty Images License Agreement. Mandatory Copyright Notice: Copyright 2023 NBAE (Photo by Michael Gonzales/NBAE via Getty Images)]]>
	</description>
	<copyright>Getty</copyright>
	<links>
		<link width="2400" height="1608" href="/headshots/players/00c2c640-3ab9-4117-a359-8938fd9a9be1/original.png"/>
		<link width="205" height="205" href="/headshots/players/00c2c640-3ab9-4117-a359-8938fd9a9be1/205x205-crop.png"/>
		<link width="90" height="90" href="/headshots/players/00c2c640-3ab9-4117-a359-8938fd9a9be1/90x90-crop.png"/>
		<link width="250" height="250" href="/headshots/players/00c2c640-3ab9-4117-a359-8938fd9a9be1/250x250-crop.png"/>
	</links>
	<refs>
		<ref name="Joens, Ashley" type="profile" sport="wnba" sportradar_id="84b8f0b9-a568-4b36-9ca0-d0b9b532eef1" primary="true">
			<entity_id origin="SR" id="1617974" sport="wnba"/>
			<entity_id origin="SD" id="84b8f0b9-a568-4b36-9ca0-d0b9b532eef1" sport="wnba"/>
		</ref>
		<ref name="Dallas Wings" type="organization" sport="wnba" sportradar_id="5f0b5caf-708b-4300-92f2-53b51d83ec06">
			<entity_id origin="SR" id="3450" sport="wnba"/>
			<entity_id origin="SD" id="5f0b5caf-708b-4300-92f2-53b51d83ec06" sport="wnba"/>
		</ref>
	</refs>
	<provider name="getty">
		<provider_item_id>1253336679</provider_item_id>
		<original_publish>2023-05-08T00:00:00+00:00</original_publish>
	</provider>
</asset>

Widgets

Our WNBA Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the sr_ids found in the WNBA API.



Game IDs

Each WNBA game will have its own unique identifier under game.id. See below for a sample taken from the Schedule endpoint.

<game id="a0c81135-419b-46e1-b1e6-5f9fd9d56208" status="closed" coverage="full" scheduled="2024-05-14T23:00:00Z" home_points="80" away_points="85" track_on_court="true" sr_id="sr:match:46601521" reference="1022400001" cc_cup="false" home_team="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" away_team="08ed8274-e29f-4248-bc2e-83cc8ed18d75">
	<time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
	<venue id="84776b5f-b41b-4356-a5ed-3a2c28ab2597" name="St. Elizabeths East Entertainment and Sports Arena" capacity="4200" address="1100 Oak Street SE" city="Washington" state="DC" zip="20032" country="USA" sr_id="sr:venue:35680">
		<location lat="38.846767" lng="-76.991422"/>
	</venue>
	<home name="Washington Mystics" alias="WAS" id="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" sr_id="sr:team:3454"></home>
	<away name="New York Liberty" alias="NYL" id="08ed8274-e29f-4248-bc2e-83cc8ed18d75" sr_id="sr:team:3446"></away>
	<broadcasts>
		<broadcast network="ESPN3" type="Internet"/>
		<broadcast network="Monumental" type="Internet" locale="Home"/>
		<broadcast network="WWOR" type="TV" locale="Away"/>
	</broadcasts>
</game>
{
"games": [
    {
      "id": "a0c81135-419b-46e1-b1e6-5f9fd9d56208",
      "status": "closed",
      "coverage": "full",
      "scheduled": "2024-05-14T23:00:00Z",
      "home_points": 80,
      "away_points": 85,
      "track_on_court": true,
      "sr_id": "sr:match:46601521",
      "reference": "1022400001",
      "cc_cup": false,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Eastern"
      },
      "venue": {
        "id": "84776b5f-b41b-4356-a5ed-3a2c28ab2597",
        "name": "St. Elizabeths East Entertainment and Sports Arena",
        "capacity": 4200,
        "address": "1100 Oak Street SE",
        "city": "Washington",
        "state": "DC",
        "zip": "20032",
        "country": "USA",
        "sr_id": "sr:venue:35680",
        "location": {
          "lat": "38.846767",
          "lng": "-76.991422"
        }
      },
      "broadcasts": [
        {
          "network": "ESPN3",
          "type": "Internet"
        },
        {
          "network": "Monumental",
          "type": "Internet",
          "locale": "Home"
        },
        {
          "network": "WWOR",
          "type": "TV",
          "locale": "Away"
        }
      ],
      "home": {
        "name": "Washington Mystics",
        "alias": "WAS",
        "id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
        "sr_id": "sr:team:3454"
      },
      "away": {
        "name": "New York Liberty",
        "alias": "NYL",
        "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
        "sr_id": "sr:team:3446"
      }
    }
  ]
}

Once created, game IDs are unchanging, except in the rare case that a game is postponed, or a game is mistakenly created twice (the duplicated UUID would be removed).



Team IDs

Each WNBA team will have its own unique identifier under team.id. You can locate all active teams in the League Hierarchy feed, and all active teams in our WNBA database in the Teams feed.

<team id="171b097d-01db-4ae8-9d56-035689402ec6" name="Aces" alias="LVA" market="Las Vegas"/>
<team id="396a7b38-7547-43ff-a0f6-328dc04512e7" name="Delle Donne" alias="EDD" market="Team"/>
<team id="5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4" name="Dream" alias="ATL" market="Atlanta"/>
{
  "id": "092510cf-3285-48bb-b831-40ac3608ca36",
  "name": "EASTERN CONFERENCE",
  "alias": "EASTERN-W",
  "teams": [
    {
      "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
      "name": "Liberty",
      "market": "New York",
      "alias": "NYL",
      "franchise_id": "8675491c-69a6-4097-bb00-46636be26670",
      "sr_id": "sr:team:3446",
      "founded": 1997,
      "owner": "Joseph Tsai and Clara Wu Tsai",
      "general_manager": "Jonathan Kolb",
      "president": "Keia Clarke",
      "mascot": "Ellie the Elephant",
      "sponsor": "Webull",
      "championships_won": 1,
      "championship_seasons": "2024",
      "conference_titles": 3,
      "playoff_appearances": 19,
      "reference": "1611661313",
      "team_colors": [
        {
          "type": "primary",
          "hex_color": "#86cebc",
          "rgb_color": {
            "red": 134,
            "green": 206,
            "blue": 188
          }
        },
        {
          "type": "secondary",
          "hex_color": "#000000",
          "rgb_color": {
            "red": 0,
            "green": 0,
            "blue": 0
          }
        }
      ],
      "venue": {
        "id": "7a330bcd-ac0f-50ca-bc29-2460e5c476b3",
        "name": "Barclays Center",
        "capacity": 17732,
        "address": "620 Atlantic Avenue",
        "city": "Brooklyn",
        "state": "NY",
        "zip": "11217",
        "country": "USA",
        "sr_id": "sr:venue:36132",
        "location": {
          "lat": "40.682957",
          "lng": "-73.975165"
        }
      }
    },
    {
      "id": "3c409388-ab73-4c7f-953d-3a71062240f6",
      "name": "Sky",
      "market": "Chicago",
      "alias": "CHI",
      "franchise_id": "8a8488f8-068a-4eea-8e39-89aa54671c9b",
      "sr_id": "sr:team:35546",
      "founded": 2006,
      "owner": "Michael J. Alter",
      "general_manager": "Jeff Pagliocca",
      "president": "Adam Fox",
      "mascot": "Sky Guy",
      "sponsor": "UChicago Medicine",
      "championships_won": 1,
      "championship_seasons": "2021",
      "conference_titles": 1,
      "playoff_appearances": 9,
      "reference": "1611661329",
      "team_colors": [
        {
          "type": "secondary",
          "hex_color": "#ffd520",
          "rgb_color": {
            "red": 255,
            "green": 213,
            "blue": 32
          }
        },
        {
          "type": "primary",
          "hex_color": "#5091cd",
          "rgb_color": {
            "red": 80,
            "green": 145,
            "blue": 205
          }
        }
      ],
      "venue": {
        "id": "fa4fcd34-792a-4cdc-a7df-a41e9d54a2b0",
        "name": "Wintrust Arena",
        "capacity": 10387,
        "address": "200 East Cermak Road",
        "city": "Chicago",
        "state": "IL",
        "zip": "60616",
        "country": "USA",
        "sr_id": "sr:venue:22190",
        "location": {
          "lat": "41.853611",
          "lng": "-87.621389"
        }
      }
    }
  ]
}

Team Relocation

Team IDs will not change once created. Even if a team relocates their ID will remain the same.


TBD Teams

Within the Teams feed, you will find a TBD team. This unique ID can be used to populate game information when game matchups are not yet known. You can find more info on this process in the Playoffs integration scenario.

<team id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" name="TBD" market="Team" alias="TBD"/>



Player IDs

Each WNBA player will have their own unique identifier under player.id. You can locate all active players on a given team in the Team Profile endpoint, and retrieve detailed player biographical info and stats in the Player Profile endpoint.

Player IDs will not change once created.

<team xmlns="http://feed.elasticstats.com/schema/basketball/team-v8.0.xsd" id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" name="Lynx" market="Minnesota" alias="MIN" founded="1999" sr_id="sr:team:3440" owner="Glen Taylor, Alex Rodriguez, and Marc Lore" general_manager="Clare Duwelius" president="Carley Knox" mascot="Prowl" sponsor="Mayo Clinic" championships_won="4" championship_seasons="2011, 2013, 2015, 2017" conference_titles="4" retired_numbers="13, 23, 32, 33, 34" playoff_appearances="15" reference="1611661324">
  <venue id="7aed802e-3562-5b73-af1b-3859529f9b95" name="Target Center" capacity="19356" address="600 First Avenue North" city="Minneapolis" state="MN" zip="55403" country="USA" sr_id="sr:venue:6930">
    <location lat="44.979444" lng="-93.276111"/>
  </venue>
  <hierarchy>
    <league id="59c24590-0adb-4b3d-80a8-10450f83f4a1" name="WNBA" alias="WNBA"/>
    <conference id="d95b23c8-dee5-4142-ac4a-2b4ab05beebc" name="WESTERN CONFERENCE" alias="WESTERN-W"/>
  </hierarchy>
  <coaches>
    <coach id="c589c101-d7ab-4c7c-b5b9-eab5405d0583" full_name="Cheryl Reeve" first_name="Cheryl" last_name="Reeve" position="Head Coach" experience="11"/>
  </coaches>
  <team_colors>
    <team_color type="secondary" hex_color="#266092">
      <rgb_color red="38" green="96" blue="146"/>
    </team_color>
    <team_color type="primary" hex_color="#0c233f">
      <rgb_color red="12" green="35" blue="63"/>
    </team_color>
  </team_colors>
  <players>
    <player id="032ba7d1-7430-4a82-9e28-6f340023833f" status="ACT" full_name="Alissa Pili" first_name="Alissa" last_name="Pili" abbr_name="A.Pili" height="74" weight="235" position="F" primary_position="NA" jersey_number="35" experience="0" college="Utah" high_school="Dimond (AK)" birth_place="Anchorage, AK, USA" birthdate="2001-06-08" updated="2024-05-15T16:31:21Z" sr_id="sr:player:2272783" rookie_year="2024" reference="1642293">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2024" round="1" pick="8"/>
    </player>
    <player id="21f994d2-1cc9-4d83-b278-abc3aaf4f63d" status="ACT" full_name="Napheesa Collier" first_name="Napheesa" last_name="Collier" abbr_name="N.Collier" height="73" weight="173" position="F" primary_position="NA" jersey_number="24" experience="5" college="UConn" high_school="Incarnate Word Academy (MO)" birth_place="Jefferson City, MO, USA" birthdate="1996-09-23" updated="2024-05-15T16:30:08Z" sr_id="sr:player:1148330" rookie_year="2019" reference="1629483">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2019" round="1" pick="6"/>
    </player>
    <player id="43135c04-f4c8-490d-ad59-0eb2e9f2f6cf" status="ACT" full_name="Natisha Hiedeman" first_name="Natisha" last_name="Hiedeman" abbr_name="N.Hiedeman" height="68" weight="128" position="G" primary_position="NA" jersey_number="2" experience="5" college="Marquette" high_school="Green Bay Southwest (WI)" birth_place="Green Bay, WI, USA" birthdate="1997-02-10" updated="2024-05-15T16:22:30Z" sr_id="sr:player:1150318" rookie_year="2019" reference="1629567">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2019" round="2" pick="18"/>
    </player>
    <player id="444bce18-54b4-4e5b-80f1-96f7ba6fe296" status="NWT" full_name="Jessica Shepard" first_name="Jessica" last_name="Shepard" abbr_name="J.Shepard" height="76" weight="186" position="F" primary_position="NA" experience="3" college="Notre Dame" high_school="Fremont (NE)" birth_place="Fremont, NE, USA" birthdate="1996-09-11" updated="2024-05-03T16:49:42Z" sr_id="sr:player:1148202" rookie_year="2019" reference="1629491">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2019" round="2" pick="16"/>
    </player>
    <player id="45e35318-295a-4e1c-bfc6-c7b295ed5066" status="ACT" full_name="Courtney Williams" first_name="Courtney" last_name="Williams" abbr_name="C.Williams" height="68" weight="142" position="G" primary_position="NA" jersey_number="10" experience="8" college="South Florida " high_school="Charlton County (GA)" birth_place="Folkston, GA, USA" birthdate="1994-05-11" updated="2024-05-15T16:28:05Z" sr_id="sr:player:1157024" rookie_year="2016" reference="1627675">
      <draft team_id="0699edf3-5993-4182-b9b4-ec935cbd4fcc" year="2016" round="1" pick="8"/>
    </player>
    <player id="8302ef7b-466b-42f0-bdae-d87d8d56154a" status="ACT" full_name="Myisha Hines-Allen" first_name="Myisha" last_name="Hines-Allen" abbr_name="M.Hines-Allen" height="73" weight="200" position="F" primary_position="NA" jersey_number="22" experience="6" college="Louisville" high_school="Montclair (NJ)" birth_place="Montclair, NJ, USA" birthdate="1996-05-30" updated="2024-10-05T01:00:07Z" sr_id="sr:player:1433885" rookie_year="2018" reference="1628899">
      <draft team_id="5c0d47fe-8539-47b0-9f36-d0b3609ca89b" year="2018" round="2" pick="19"/>
    </player>
    <player id="8d2ac434-4179-4839-a109-e306fd4b4ba1" status="ACT" full_name="Olivia Époupa" first_name="Olivia" last_name="Époupa" abbr_name="O.Époupa" height="65" weight="122" position="G" primary_position="NA" jersey_number="0" experience="0" birth_place="Paris,, FRA" birthdate="1994-04-30" updated="2024-11-06T21:11:21Z" sr_id="sr:player:2038493" rookie_year="2024" reference="1630151">
    </player>
    <player id="92b50919-8c76-4fcf-ab2e-9497f135f27c" status="ACT" full_name="Cecilia Zandalasini" first_name="Cecilia" last_name="Zandalasini" abbr_name="C.Zandalasini" height="74" weight="175" position="F" primary_position="NA" jersey_number="9" experience="2" birth_place="Broni,, ITA" birthdate="1996-03-16" updated="2024-05-14T13:46:50Z" sr_id="sr:player:1273582" rookie_year="2017" reference="1628508">
    </player>
    <player id="96ebdfad-3ffa-4a02-9990-75977d7c94a1" status="ACT" full_name="Alanna Smith" first_name="Alanna" last_name="Smith" abbr_name="A.Smith" height="76" weight="183" position="F" primary_position="NA" jersey_number="8" experience="5" college="Stanford" high_school="Wesley College (AUS)" birth_place="Tasmania,, AUS" birthdate="1996-09-10" updated="2024-05-15T16:27:04Z" sr_id="sr:player:1147338" rookie_year="2019" reference="1629501">
      <draft team_id="0699edf3-5993-4182-b9b4-ec935cbd4fcc" year="2019" round="1" pick="8"/>
    </player>
    <player id="a4d323e8-eea6-49b4-91f2-7edd99b2fa68" status="ACT" full_name="Dorka Juhász" first_name="Dorka" last_name="Juhász" abbr_name="D.Juhász" height="77" weight="191" position="F" primary_position="NA" jersey_number="14" experience="1" college="UConn" high_school="PTE Babits (HUN)" birth_place="Pecs,, HUN" birthdate="1999-12-18" updated="2024-09-16T13:10:49Z" sr_id="sr:player:1618688" rookie_year="2023" reference="1641657">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2023" round="2" pick="16"/>
    </player>
    <player id="b404562d-a1fd-446f-bcd0-6b545dfde9c6" status="ACT" full_name="Kayla McBride" first_name="Kayla" last_name="McBride" abbr_name="K.McBride" height="71" weight="179" position="G" primary_position="NA" jersey_number="21" experience="10" college="Notre Dame" high_school="Villa Marie Academy (PA)" birth_place="Erie, PA, USA" birthdate="1992-06-25" updated="2024-05-15T16:29:41Z" sr_id="sr:player:1156934" rookie_year="2014" reference="203825">
      <draft team_id="171b097d-01db-4ae8-9d56-035689402ec6" year="2014" round="1" pick="3"/>
    </player>
    <player id="d851048b-0415-4678-9f9a-f49cc03ae802" status="ACT" full_name="Diamond Miller" first_name="Diamond" last_name="Miller" abbr_name="D.Miller" height="75" weight="179" position="F" primary_position="NA" jersey_number="1" experience="1" college="Maryland" high_school="Franklin (NJ)" birth_place="Montclair, NJ, USA" birthdate="2001-02-11" updated="2024-05-15T16:32:06Z" sr_id="sr:player:2268025" rookie_year="2023" reference="1641649">
      <draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2023" round="1" pick="2"/>
    </player>
    <player id="f41354b6-c59e-4f29-abf3-f3cff87ed231" status="ACT" full_name="Bridget Carleton" first_name="Bridget" last_name="Carleton" abbr_name="B.Carleton" height="73" weight="177" position="F" primary_position="NA" jersey_number="6" experience="5" college="Iowa State" high_school="John McGregor (CAN)" birth_place="Chatham, ON, CAN" birthdate="1997-05-22" updated="2024-05-15T16:25:23Z" sr_id="sr:player:1148872" rookie_year="2019" reference="1629524">
      <draft team_id="a015b02d-845c-40c1-8ef4-844984f47e4d" year="2019" round="2" pick="21"/>
    </player>
  </players>
</team>
{
  "id": "032ba7d1-7430-4a82-9e28-6f340023833f",
  "status": "ACT",
  "full_name": "Alissa Pili",
  "first_name": "Alissa",
  "last_name": "Pili",
  "abbr_name": "A.Pili",
  "height": 74,
  "weight": 235,
  "position": "F",
  "primary_position": "NA",
  "jersey_number": "35",
  "experience": "0",
  "college": "Utah",
  "high_school": "Dimond (AK)",
  "birth_place": "Anchorage, AK, USA",
  "birthdate": "2001-06-08",
  "updated": "2024-05-15T16:31:21Z",
  "sr_id": "sr:player:2272783",
  "rookie_year": 2024,
  "reference": "1642293",
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "team": {
    "id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
    "name": "Lynx",
    "market": "Minnesota",
    "alias": "MIN",
    "sr_id": "sr:team:3440",
    "reference": "1611661324"
  },
  "draft": {
    "team_id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
    "year": 2024,
    "round": "1",
    "pick": "8"
  },
  "seasons": [
    {
      "id": "db004e22-7ed4-4316-8302-79454224f49d",
      "year": 2024,
      "type": "REG",
      "teams": [
        {
          "id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
          "name": "Lynx",
          "market": "Minnesota",
          "alias": "MIN",
          "sr_id": "sr:team:3440",
          "reference": "1611661324",
          "total": {
            "games_played": 22,
            "games_started": 0,
            "minutes": 138,
            "field_goals_made": 19,
            "field_goals_att": 45,
            "field_goals_pct": 0.422,
            "two_points_made": 10,
            "two_points_att": 18,
            "two_points_pct": 0.556,
            "three_points_made": 9,
            "three_points_att": 27,
            "three_points_pct": 0.333,
            "blocked_att": 3,
            "free_throws_made": 6,
            "free_throws_att": 11,
            "free_throws_pct": 0.545,
            "offensive_rebounds": 6,
            "defensive_rebounds": 21,
            "rebounds": 27,
            "assists": 5,
            "turnovers": 19,
            "assists_turnover_ratio": 0.26,
            "steals": 5,
            "blocks": 2,
            "personal_fouls": 29,
            "tech_fouls": 0,
            "points": 53,
            "flagrant_fouls": 0,
            "ejections": 0,
            "foulouts": 0,
            "tech_fouls_non_unsportsmanlike": 0,
            "true_shooting_att": 49.84,
            "true_shooting_pct": 0.532,
            "efficiency": 42,
            "field_goals_at_rim_made": 7,
            "field_goals_at_rim_att": 10,
            "field_goals_at_rim_pct": 0.7,
            "field_goals_at_midrange_made": 1,
            "field_goals_at_midrange_att": 2,
            "field_goals_at_midrange_pct": 0.5,
            "usage_pct": 23.02,
            "points_off_turnovers": 18,
            "points_in_paint": 18,
            "points_in_paint_made": 9,
            "points_in_paint_att": 16,
            "points_in_paint_pct": 0.563,
            "effective_fg_pct": 0.522,
            "double_doubles": 0,
            "triple_doubles": 0,
            "fouls_drawn": 8,
            "offensive_fouls": 5,
            "fast_break_pts": 6,
            "fast_break_att": 2,
            "fast_break_made": 2,
            "fast_break_pct": 1,
            "coach_ejections": 0,
            "second_chance_pct": 0.5,
            "second_chance_pts": 10,
            "second_chance_att": 6,
            "second_chance_made": 3,
            "minus": 279,
            "plus": 248,
            "coach_tech_fouls": 0
          },
          "average": {
            "minutes": 6.3,
            "points": 2.4,
            "off_rebounds": 0.27,
            "def_rebounds": 0.95,
            "rebounds": 1.23,
            "assists": 0.2,
            "steals": 0.23,
            "blocks": 0.09,
            "turnovers": 0.86,
            "personal_fouls": 1.32,
            "flagrant_fouls": 0,
            "blocked_att": 0.14,
            "field_goals_made": 0.86,
            "field_goals_att": 2.05,
            "three_points_made": 0.41,
            "three_points_att": 1.23,
            "free_throws_made": 0.27,
            "free_throws_att": 0.5,
            "two_points_made": 0.45,
            "two_points_att": 0.82,
            "efficiency": 1.91,
            "true_shooting_att": 2.27,
            "points_off_turnovers": 0.82,
            "points_in_paint_made": 0.41,
            "points_in_paint_att": 0.73,
            "points_in_paint": 0.82,
            "fouls_drawn": 0.36,
            "offensive_fouls": 0.23,
            "fast_break_pts": 0.27,
            "fast_break_att": 0.09,
            "fast_break_made": 0.09,
            "second_chance_pts": 0.45,
            "second_chance_att": 0.27,
            "second_chance_made": 0.14
          }
        }
      ]
    }
  ]
}

Player IDs in other Products

Each WNBA player.id is specific to the WNBA API. IDs will not transfer to other basketball APIs. To learn more about linking IDs across API products visit this section.


Duplicate Player IDs

A duplicate player profile (and player.id) can be introduced by mistake. In these cases, we will mark the duplicate player with a status of DUP. All profiles marked as duplicates can be ignored, but they will remain in our database to limit confusion.

<player
	xmlns="http://feed.elasticstats.com/schema/basketball/profile-v7.0.xsd" id="21f994d2-1cc9-4d83-b278-abc3aaf4f63d" status="DUP" full_name="Napheesa Collier" first_name="Napheesa" last_name="Collier" abbr_name="N.Collier" height="73" weight="173" position="F" primary_position="NA" jersey_number="24" experience="5" college="UConn" high_school="Incarnate Word Academy (MO)" birth_place="Jefferson City, MO, USA" birthdate="1996-09-23" updated="2024-05-15T16:30:08Z" sr_id="sr:player:1148330" rookie_year="2019" reference="1629483">
	<league id="59c24590-0adb-4b3d-80a8-10450f83f4a1" name="WNBA" alias="WNBA"/>
	<team id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" name="Lynx" market="Minnesota" alias="MIN" sr_id="sr:team:3440" reference="1611661324"/>
	<draft team_id="6f017f37-be96-4bdc-b6d3-0a0429c72e89" year="2019" round="1" pick="6"/>
</player>
{
  "id": "21f994d2-1cc9-4d83-b278-abc3aaf4f63d",
  "status": "DUP",
  "full_name": "Napheesa Collier",
  "first_name": "Napheesa",
  "last_name": "Collier",
  "abbr_name": "N.Collier",
  "height": 73,
  "weight": 173,
  "position": "F",
  "primary_position": "NA",
  "jersey_number": "24",
  "experience": "5",
  "college": "UConn",
  "high_school": "Incarnate Word Academy (MO)",
  "birth_place": "Jefferson City, MO, USA",
  "birthdate": "1996-09-23",
  "updated": "2024-05-15T16:30:08Z",
  "sr_id": "sr:player:1148330",
  "rookie_year": 2019,
  "reference": "1629483",
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "team": {
    "id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
    "name": "Lynx",
    "market": "Minnesota",
    "alias": "MIN",
    "sr_id": "sr:team:3440",
    "reference": "1611661324"
  },
  "draft": {
    "team_id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
    "year": 2019,
    "round": "1",
    "pick": "6"
  },
  "seasons": []
    }

Access all Player IDs

Iterate through the past Seasonal Statistics feeds for each season and team to obtain all player IDs in the WNBA API.



Season IDs

Each WNBA season will have its own unique identifier under season.id. Season types can be Preseason (PRE), Regular Season (Regular), Postseason (PST), Commissioners Cup (CC). You can locate all historical seasons in the Seasons feed.

Season IDs will not change once created.

<league xmlns="http://feed.elasticstats.com/schema/basketball/seasons-v6.0.xsd" id="59c24590-0adb-4b3d-80a8-10450f83f4a1" name="WNBA" alias="WNBA">
<season id="11ed6ba1-6026-42f0-8a82-3da8a5e8c753" year="2024" start_date="2024-09-22" end_date="2024-10-20" status="closed">
	<type code="PST" name="Post-season"/>
</season>
<season id="44eeaa8a-7cd3-4153-abf6-32dc62098001" year="2024" start_date="2024-06-25" end_date="2024-06-26" status="closed">
	<type code="CC" name="Commissioner's Cup"/>
</season>
<season id="db004e22-7ed4-4316-8302-79454224f49d" year="2024" start_date="2024-05-14" end_date="2024-09-19" status="closed">
	<type code="REG" name="Regular Season"/>
</season>
<season id="6d989f83-e285-4fee-932a-98377c818b8a" year="2024" start_date="2024-05-03" end_date="2024-05-12" status="closed">
	<type code="PRE" name="Pre-season"/>
</season>
<season id="198c2e1c-b517-4a83-b39c-1113095c082f" year="2025" status="scheduled">
	<type code="PST" name="Post-season"/>
</season>
<season id="3fed7a39-a737-422c-be0d-561cf94c03cf" year="2025" status="scheduled">
	<type code="CC" name="Commissioner's Cup"/>
</season>
<season id="896588ff-6de9-49a9-a799-bbd7d3922cdc" year="2025" status="scheduled">
	<type code="REG" name="Regular Season"/>
</season>
<season id="9d0ca0e6-2e0d-4ef9-abc7-ff12d23334cc" year="2025" status="scheduled">
	<type code="PRE" name="Pre-season"/>
</season>undefined</league>
{
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "seasons": [
    {
      "id": "ecc325e8-e6ff-4c8b-a256-6554290a6ef7",
      "year": 2023,
      "start_date": "2023-09-13",
      "end_date": "2023-10-20",
      "status": "closed",
      "type": {
        "code": "PST",
        "name": "Post-season"
      }
    },
    {
      "id": "5be64ff6-57bb-4d68-8881-78f8673eebd7",
      "year": 2023,
      "start_date": "2023-08-15",
      "end_date": "2023-08-16",
      "status": "closed",
      "type": {
        "code": "CC",
        "name": "Commissioner's Cup"
      }
    },
    {
      "id": "825bcfa1-45a6-4d71-91d9-c9f46ec11a0e",
      "year": 2023,
      "start_date": "2023-05-19",
      "end_date": "2023-09-10",
      "status": "closed",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "56c66e03-5c3c-4bb5-9cc1-b5ac23978ceb",
      "year": 2023,
      "start_date": "2023-05-05",
      "end_date": "2023-05-18",
      "status": "closed",
      "type": {
        "code": "PRE",
        "name": "Pre-season"
      }
    },
    {
      "id": "11ed6ba1-6026-42f0-8a82-3da8a5e8c753",
      "year": 2024,
      "start_date": "2024-09-22",
      "end_date": "2024-10-20",
      "status": "closed",
      "type": {
        "code": "PST",
        "name": "Post-season"
      }
    },
    {
      "id": "44eeaa8a-7cd3-4153-abf6-32dc62098001",
      "year": 2024,
      "start_date": "2024-06-25",
      "end_date": "2024-06-26",
      "status": "closed",
      "type": {
        "code": "CC",
        "name": "Commissioner's Cup"
      }
    },
    {
      "id": "db004e22-7ed4-4316-8302-79454224f49d",
      "year": 2024,
      "start_date": "2024-05-14",
      "end_date": "2024-09-19",
      "status": "closed",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "6d989f83-e285-4fee-932a-98377c818b8a",
      "year": 2024,
      "start_date": "2024-05-03",
      "end_date": "2024-05-12",
      "status": "closed",
      "type": {
        "code": "PRE",
        "name": "Pre-season"
      }
    },
    {
      "id": "198c2e1c-b517-4a83-b39c-1113095c082f",
      "year": 2025,
      "status": "scheduled",
      "type": {
        "code": "PST",
        "name": "Post-season"
      }
    },
    {
      "id": "3fed7a39-a737-422c-be0d-561cf94c03cf",
      "year": 2025,
      "status": "scheduled",
      "type": {
        "code": "CC",
        "name": "Commissioner's Cup"
      }
    },
    {
      "id": "896588ff-6de9-49a9-a799-bbd7d3922cdc",
      "year": 2025,
      "status": "scheduled",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "9d0ca0e6-2e0d-4ef9-abc7-ff12d23334cc",
      "year": 2025,
      "status": "scheduled",
      "type": {
        "code": "PRE",
        "name": "Pre-season"
      }
    }
  ]
}


Venue IDs

Each WNBA venue will have its own unique identifier under venue.id. You can locate all active team venues in League Hierarchy, and each Game feed will include the venue ID for that matchup.

Venue IDs will not change once created.

<team id="08ed8274-e29f-4248-bc2e-83cc8ed18d75" name="Liberty" market="New York" alias="NYL" franchise_id="8675491c-69a6-4097-bb00-46636be26670" sr_id="sr:team:3446" founded="1997" owner="Joseph Tsai and Clara Wu Tsai" general_manager="Jonathan Kolb" president="Keia Clarke" mascot="Ellie the Elephant" sponsor="Webull" championships_won="1" championship_seasons="2024" conference_titles="3" playoff_appearances="19" reference="1611661313">
	<team_colors>
		<team_color type="primary" hex_color="#86cebc">
			<rgb_color red="134" green="206" blue="188"/>
		</team_color>
		<team_color type="secondary" hex_color="#000000">
			<rgb_color red="0" green="0" blue="0"/>
		</team_color>
	</team_colors>
	<venue id="7a330bcd-ac0f-50ca-bc29-2460e5c476b3" name="Barclays Center" capacity="17732" address="620 Atlantic Avenue" city="Brooklyn" state="NY" zip="11217" country="USA" sr_id="sr:venue:36132">
		<location lat="40.682957" lng="-73.975165"/>
	</venue>
{
"teams": [
  {
    "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
    "name": "Liberty",
    "market": "New York",
    "alias": "NYL",
    "franchise_id": "8675491c-69a6-4097-bb00-46636be26670",
    "sr_id": "sr:team:3446",
    "founded": 1997,
    "owner": "Joseph Tsai and Clara Wu Tsai",
    "general_manager": "Jonathan Kolb",
    "president": "Keia Clarke",
    "mascot": "Ellie the Elephant",
    "sponsor": "Webull",
    "championships_won": 1,
    "championship_seasons": "2024",
    "conference_titles": 3,
    "playoff_appearances": 19,
    "reference": "1611661313",
    "team_colors": [
      {
        "type": "primary",
        "hex_color": "#86cebc",
        "rgb_color": {
          "red": 134,
          "green": 206,
          "blue": 188
        }
      },
      {
        "type": "secondary",
        "hex_color": "#000000",
        "rgb_color": {
          "red": 0,
          "green": 0,
          "blue": 0
        }
      }
    ],
    "venue": {
      "id": "7a330bcd-ac0f-50ca-bc29-2460e5c476b3",
      "name": "Barclays Center",
      "capacity": 17732,
      "address": "620 Atlantic Avenue",
      "city": "Brooklyn",
      "state": "NY",
      "zip": "11217",
      "country": "USA",
      "sr_id": "sr:venue:36132",
      "location": {
        "lat": "40.682957",
        "lng": "-73.975165"
      }
    }
  }
]
}

The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.