Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Rosters and Player Statuses

This guide offers detailed instructions on accessing WNBA rosters. Learn to retrieve updates on player transfers, team rosters, game rosters, on-court participants, player statuses, and injuries.

Introduction to Rosters

A WNBA roster is essentially the lineup of players registered under a team. You can access rosters using the Team Profile feed. This endpoint provides top-level team information and a full roster of active player

How Preseason Roster Information is Updated
  • During the preseason, we match team roster information with the WNBA. As training camp approaches, teams release their official rosters.
  • For WNBA training camps, we include players signed to standard contracts, non-guaranteed training camp contracts, and recent draftees invited to compete for a spot.
  • Preseason camps are capped at 18 players, but the roster is trimmed to 12 players when the season starts.


Accessing Team and Game Rosters

How do I get the most up-to-date team roster for each WNBA team?
  1. Get a team ID: You can access a list of all active teams in the WNBA API database with the Teams endpoint.
  2. Use your team ID to call the Team Profile endpoint

Team Profile Update Frequency and Recommended Retrieval Times:

  • Updates are as necessary as changes are made to rosters or player profiles.
  • Pull every hour or less depending on your use case.
  • The TTL/Cache is 300 seconds.

Team Profile Response Example

{
  "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
  "name": "Dream",
  "market": "Atlanta",
  "alias": "ATL",
  "founded": 2008,
  "sr_id": "sr:team:35545",
  "owner": "Larry Gottesdiener, Suzanne Abair, and Renee Montgomery",
  "general_manager": "Dan Padover",
  "president": "Morgan Shaw Parker",
  "mascot": "Star",
  "sponsor": "Emory Healthcare",
  "championships_won": 0,
  "conference_titles": 3,
  "playoff_appearances": 10,
  "reference": "1611661330",
  "venue": {
    "id": "bd2b9175-3436-4d8a-b3c1-2c8924f4590b",
    "name": "Gateway Center Arena",
    "capacity": 3500,
    "address": "2330 Convention Center Concourse",
    "city": "College Park",
    "state": "GA",
    "zip": "30337",
    "country": "USA",
    "sr_id": "sr:venue:47490",
    "location": {
      "lat": "33.646171",
      "lng": "-84.458691"
    }
  },
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "conference": {
    "id": "092510cf-3285-48bb-b831-40ac3608ca36",
    "name": "EASTERN CONFERENCE",
    "alias": "EASTERN-W"
  },
  "coaches": [
    {
      "id": "2f88a142-5831-46ee-a751-52298f97b321",
      "full_name": "Karl Smesko",
      "first_name": "Karl",
      "last_name": "Smesko",
      "position": "Head Coach"
    }
  ],
  "team_colors": [
    {
      "type": "secondary",
      "hex_color": "#373a36",
      "rgb_color": {
        "red": 55,
        "green": 58,
        "blue": 54
      }
    },
    {
      "type": "primary",
      "hex_color": "#e31837",
      "rgb_color": {
        "red": 227,
        "green": 24,
        "blue": 55
      }
    }
  ],
  "players": [
    {
      "id": "03e541cb-d11c-4975-b656-f6e7febcda7d",
      "status": "ACT",
      "full_name": "Brittney Griner",
      "first_name": "Brittney",
      "last_name": "Griner",
      "abbr_name": "B.Griner",
      "height": 81,
      "weight": 205,
      "position": "C",
      "primary_position": "NA",
      "jersey_number": "42",
      "experience": "11",
      "college": "Baylor",
      "high_school": "Nimitz (TX)",
      "birth_place": "Houston, TX, USA",
      "birthdate": "1990-10-18",
      "updated": "2025-02-15T12:37:09Z",
      "sr_id": "sr:player:1156880",
      "rookie_year": 2013,
      "reference": "203398",
      "draft": {
        "team_id": "0699edf3-5993-4182-b9b4-ec935cbd4fcc",
        "year": 2013,
        "round": "1",
        "pick": "1"
      }
    },
    {
      "id": "293b5925-fd31-4640-8ada-bf6451a2c488",
      "status": "ACT",
      "full_name": "Allisha Gray",
      "first_name": "Allisha",
      "last_name": "Gray",
      "abbr_name": "A.Gray",
      "height": 72,
      "weight": 167,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "15",
      "experience": "8",
      "college": "South Carolina",
      "high_school": "Washington County (GA)",
      "birth_place": "Greenwood, SC, USA",
      "birthdate": "1995-01-12",
      "updated": "2025-02-15T12:34:16Z",
      "sr_id": "sr:player:1157078",
      "rookie_year": 2017,
      "reference": "1628277",
      "draft": {
        "team_id": "5f0b5caf-708b-4300-92f2-53b51d83ec06",
        "year": 2017,
        "round": "1",
        "pick": "4"
      }
    },
    {
      "id": "3762be5d-d392-4e3b-aea3-9c5e356c7486",
      "status": "ACT",
      "full_name": "Shatori Walker-Kimbrough",
      "first_name": "Shatori",
      "last_name": "Walker-Kimbrough",
      "abbr_name": "S.Walker-Kimbrough",
      "height": 69,
      "weight": 140,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "32",
      "experience": "8",
      "college": "Maryland",
      "high_school": "Hopewell (PA)",
      "birth_place": "Aliquippa, PA, USA",
      "birthdate": "1995-05-18",
      "updated": "2025-02-15T12:35:18Z",
      "sr_id": "sr:player:1156820",
      "rookie_year": 2017,
      "reference": "1628278",
      "draft": {
        "team_id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
        "year": 2017,
        "round": "1",
        "pick": "6"
      }
    },
    {
      "id": "3763f098-4cd1-47ca-8666-6cf9c8b6812b",
      "status": "ACT",
      "full_name": "Taylor Thierry",
      "first_name": "Taylor",
      "last_name": "Thierry",
      "abbr_name": "T.Thierry",
      "height": 73,
      "position": "G-F",
      "primary_position": "NA",
      "jersey_number": "5",
      "experience": "0",
      "college": "Ohio State",
      "high_school": "Laurel (OH)",
      "birth_place": "Cleveland, OH, USA",
      "birthdate": "2003-01-08",
      "updated": "2025-05-03T20:17:36Z",
      "sr_id": "sr:player:2268365",
      "reference": "1642814",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2025,
        "round": "3",
        "pick": "36"
      }
    },
    {
      "id": "43e2f045-e419-4b6e-bf2c-45e45f4720cc",
      "status": "ACT",
      "full_name": "Jordin Canada",
      "first_name": "Jordin",
      "last_name": "Canada",
      "abbr_name": "J.Canada",
      "height": 66,
      "weight": 135,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "3",
      "experience": "7",
      "college": "UCLA",
      "high_school": "Windward School (CA)",
      "birth_place": "Los Angeles, CA, USA",
      "birthdate": "1995-08-11",
      "updated": "2025-02-15T12:30:28Z",
      "sr_id": "sr:player:1152198",
      "rookie_year": 2018,
      "reference": "1628886",
      "draft": {
        "team_id": "d6a012ed-84aa-48d3-8265-2d3f3ff2199a",
        "year": 2018,
        "round": "1",
        "pick": "5"
      }
    },
    {
      "id": "46719991-b25b-4b9d-a876-a2aa1dc31669",
      "status": "ACT",
      "full_name": "Lorela Cubaj",
      "first_name": "Lorela",
      "last_name": "Cubaj",
      "abbr_name": "L.Cubaj",
      "height": 76,
      "weight": 200,
      "position": "F-C",
      "primary_position": "NA",
      "jersey_number": "19",
      "experience": "2",
      "college": "Georgia Tech",
      "high_school": "Istituto Paritario Giuseppe Parini (ITA)",
      "birth_place": "Perugia,, ITA",
      "birthdate": "1999-01-08",
      "updated": "2024-05-26T22:47:26Z",
      "sr_id": "sr:player:2331799",
      "rookie_year": 2022,
      "reference": "1631032",
      "draft": {
        "team_id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
        "year": 2022,
        "round": "2",
        "pick": "18"
      }
    },
    {
      "id": "58c646ba-6e6f-409a-a1cf-83e253991797",
      "status": "ACT",
      "full_name": "Nia Coffey",
      "first_name": "Nia",
      "last_name": "Coffey",
      "abbr_name": "N.Coffey",
      "height": 73,
      "weight": 182,
      "position": "F",
      "primary_position": "NA",
      "jersey_number": "12",
      "experience": "8",
      "college": "Northwestern",
      "high_school": "Hopkins (MN)",
      "birth_place": "Minneapolis, MN, USA",
      "birthdate": "1995-06-11",
      "updated": "2025-02-15T12:32:04Z",
      "sr_id": "sr:player:1156814",
      "rookie_year": 2017,
      "reference": "1628269",
      "draft": {
        "team_id": "171b097d-01db-4ae8-9d56-035689402ec6",
        "year": 2017,
        "round": "1",
        "pick": "5"
      }
    },
    {
      "id": "7c97d5bc-1718-4284-9d85-87f2f1b23eec",
      "status": "ACT",
      "full_name": "Haley Jones",
      "first_name": "Haley",
      "last_name": "Jones",
      "abbr_name": "H.Jones",
      "height": 73,
      "weight": 187,
      "position": "F-G",
      "primary_position": "NA",
      "jersey_number": "13",
      "experience": "2",
      "college": "Stanford",
      "high_school": "Archbishop Mitty (CA)",
      "birth_place": "Santa Cruz, CA, USA",
      "birthdate": "2001-05-23",
      "updated": "2025-02-15T12:32:48Z",
      "sr_id": "sr:player:1947700",
      "rookie_year": 2023,
      "reference": "1641650",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2023,
        "round": "1",
        "pick": "6"
      }
    },
    {
      "id": "84b8f0b9-a568-4b36-9ca0-d0b9b532eef1",
      "status": "ACT",
      "full_name": "Ashley Joens",
      "first_name": "Ashley",
      "last_name": "Joens",
      "abbr_name": "A.Joens",
      "height": 73,
      "weight": 160,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "20",
      "experience": "1",
      "college": "Iowa State",
      "high_school": "Iowa City (IA)",
      "birth_place": "Iowa City, IA, USA",
      "birthdate": "2000-03-16",
      "updated": "2025-04-25T17:20:46Z",
      "sr_id": "sr:player:1617974",
      "reference": "1641653",
      "draft": {
        "team_id": "5f0b5caf-708b-4300-92f2-53b51d83ec06",
        "year": 2023,
        "round": "2",
        "pick": "19"
      }
    },
    {
      "id": "9892a343-6590-401b-8ffe-4acf130e0642",
      "status": "ACT",
      "full_name": "Emani Jefferson",
      "first_name": "Emani",
      "last_name": "Jefferson",
      "abbr_name": "E.Jefferson",
      "height": 66,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "1",
      "experience": "0",
      "college": "Florida Gulf Coast",
      "high_school": "North Port (FL)",
      "birth_place": "Miami, FL, USA",
      "birthdate": "2002-01-17",
      "updated": "2025-04-25T17:10:33Z",
      "sr_id": "sr:player:2108022"
    },
    {
      "id": "9be2b4ab-ddfa-4d14-8968-d2c82644a7c0",
      "status": "ACT",
      "full_name": "Maria Gakdeng",
      "first_name": "Maria",
      "last_name": "Gakdeng",
      "abbr_name": "M.Gakdeng",
      "height": 75,
      "position": "F-C",
      "primary_position": "NA",
      "jersey_number": "6",
      "experience": "0",
      "college": "North Carolina",
      "high_school": "New Hope Academy (MD)",
      "birth_place": "Lanham, MD, USA",
      "birthdate": "2003-06-09",
      "updated": "2025-04-25T17:14:18Z",
      "sr_id": "sr:player:2242109"
    },
    {
      "id": "ab39141d-852e-4308-8b5d-8d06441ffbbd",
      "status": "ACT",
      "full_name": "Rhyne Howard",
      "first_name": "Rhyne",
      "last_name": "Howard",
      "abbr_name": "R.Howard",
      "height": 74,
      "weight": 175,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "10",
      "experience": "3",
      "college": "Kentucky",
      "high_school": "Bradley Central (TN)",
      "birth_place": "Chattanooga, TN, USA",
      "birthdate": "2000-04-29",
      "updated": "2025-02-15T12:31:14Z",
      "sr_id": "sr:player:1618836",
      "rookie_year": 2022,
      "reference": "1631009",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2022,
        "round": "1",
        "pick": "1"
      }
    },
    {
      "id": "b2bb37a6-6879-4c1f-ae20-5f6492bef87a",
      "status": "ACT",
      "full_name": "Naz Hillmon",
      "first_name": "Naz",
      "last_name": "Hillmon",
      "abbr_name": "N.Hillmon",
      "height": 74,
      "weight": 190,
      "position": "F",
      "primary_position": "NA",
      "jersey_number": "0",
      "experience": "3",
      "college": "Michigan",
      "high_school": "Gilmour Academy (OH)",
      "birth_place": "Cleveland, OH, USA",
      "birthdate": "2000-04-05",
      "updated": "2025-04-23T21:43:06Z",
      "sr_id": "sr:player:2331793",
      "rookie_year": 2022,
      "reference": "1631044",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2022,
        "round": "2",
        "pick": "15"
      }
    },
    {
      "id": "c8b2f823-27fb-4793-b7e9-690de18cc2a3",
      "status": "NWT",
      "full_name": "Isobel Borlase",
      "first_name": "Isobel",
      "last_name": "Borlase",
      "abbr_name": "I.Borlase",
      "height": 71,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "birth_place": "Adelaide,, AUS",
      "birthdate": "2004-09-12",
      "updated": "2024-05-03T17:31:12Z",
      "sr_id": "sr:player:2789031",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2024,
        "round": "2",
        "pick": "20"
      }
    },
    {
      "id": "dbb209ce-245a-44a6-893a-324e76638b07",
      "status": "ACT",
      "full_name": "Shyanne Sellers",
      "first_name": "Shyanne",
      "last_name": "Sellers",
      "abbr_name": "S.Sellers",
      "height": 74,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "1",
      "experience": "0",
      "college": "Maryland",
      "high_school": "Aurora (OH)",
      "birth_place": "Aurora, OH, USA",
      "birthdate": "2003-04-24",
      "updated": "2025-05-06T19:13:25Z",
      "sr_id": "sr:player:2268023",
      "reference": "1642811",
      "draft": {
        "team_id": "4f57ec40-0d35-4b59-bea0-9d040f0d2292",
        "year": 2025,
        "round": "2",
        "pick": "17"
      }
    },
    {
      "id": "de11f82d-035c-45c2-873a-eb1fad4abc1b",
      "status": "ACT",
      "full_name": "Brionna Jones",
      "first_name": "Brionna",
      "last_name": "Jones",
      "abbr_name": "B.Jones",
      "height": 75,
      "weight": 215,
      "position": "F",
      "primary_position": "NA",
      "jersey_number": "24",
      "experience": "8",
      "college": "Maryland",
      "high_school": "Aberdeen (MD)",
      "birth_place": "Harve de Grace, MD, USA",
      "birthdate": "1995-12-18",
      "updated": "2025-03-20T15:04:27Z",
      "sr_id": "sr:player:1156804",
      "rookie_year": 2017,
      "reference": "1628280",
      "draft": {
        "team_id": "a015b02d-845c-40c1-8ef4-844984f47e4d",
        "year": 2017,
        "round": "1",
        "pick": "8"
      }
    },
    {
      "id": "dffb18cb-675a-4bdf-b037-2e9f5d340c46",
      "status": "NWT",
      "full_name": "Matilde Villa",
      "first_name": "Matilde",
      "last_name": "Villa",
      "abbr_name": "M.Villa",
      "height": 67,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "birth_place": ",, ITA",
      "birthdate": "2004-12-09",
      "updated": "2024-05-03T17:34:21Z",
      "sr_id": "sr:player:2789029",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2024,
        "round": "3",
        "pick": "32"
      }
    },
    {
      "id": "e7fb06e6-823e-4f60-955c-639a49bc860d",
      "status": "ACT",
      "full_name": "Te-Hina Paopao",
      "first_name": "Te-Hina",
      "last_name": "Paopao",
      "abbr_name": "T.Paopao",
      "height": 69,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "2",
      "experience": "0",
      "college": "South Carolina",
      "high_school": "La Jolia Country Day (CA)",
      "birth_place": "Oceanside, CA, USA",
      "birthdate": "2002-08-21",
      "updated": "2025-05-03T20:07:36Z",
      "sr_id": "sr:player:2105062",
      "reference": "1642804",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2025,
        "round": "2",
        "pick": "18"
      }
    },
    {
      "id": "f473955f-a823-4328-92ea-6b06b68b2118",
      "status": "ACT",
      "full_name": "Maya Caldwell",
      "first_name": "Maya",
      "last_name": "Caldwell",
      "abbr_name": "M.Caldwell",
      "height": 71,
      "weight": 160,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "33",
      "experience": "3",
      "college": "Georgia",
      "high_school": "Davidson Day School (NC)",
      "birth_place": "Charlotte, NC, USA",
      "birthdate": "1998-12-15",
      "updated": "2025-02-15T12:36:09Z",
      "sr_id": "sr:player:2146754",
      "rookie_year": 2022,
      "reference": "1630471",
      "draft": {
        "team_id": "f073a15f-0486-4179-b0a3-dfd0294eb595",
        "year": 2021,
        "round": "3",
        "pick": "33"
      }
    },
    {
      "id": "f7faa479-7be2-4164-8db9-68ab603c1ae0",
      "status": "NWT",
      "full_name": "Nyadiew Puoch",
      "first_name": "Nyadiew",
      "last_name": "Puoch",
      "abbr_name": "N.Puoch",
      "height": 75,
      "position": "F",
      "primary_position": "NA",
      "experience": "0",
      "birth_place": ",, AUS",
      "birthdate": "2004-06-23",
      "updated": "2024-05-03T17:36:23Z",
      "sr_id": "sr:player:2734406",
      "draft": {
        "team_id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
        "year": 2024,
        "round": "1",
        "pick": "12"
      }
    },
    {
      "id": "fd230821-bfd6-46f2-9dfe-ef4770a8fa4a",
      "status": "ACT",
      "full_name": "Holly Winterburn",
      "first_name": "Holly",
      "last_name": "Winterburn",
      "abbr_name": "H.Winterburn",
      "height": 71,
      "position": "G",
      "primary_position": "NA",
      "jersey_number": "7",
      "experience": "FR",
      "college": "Oregon",
      "birth_place": "Northampton,, GBR",
      "birthdate": "2000-10-01",
      "updated": "2025-03-21T00:00:43Z",
      "sr_id": "sr:player:1950952",
      "injuries": [
        {
          "id": "82896c93-698b-42a7-a66d-5e1b1b5f9bb9",
          "comment": "The Atlanta Dream announced G Holly Winterburn will miss the 2025-26 season.",
          "desc": "Personal",
          "status": "Out For Season",
          "start_date": "2025-04-07",
          "update_date": "2025-04-07"
        }
      ]
    }
  ]
}

Use Cases:

If you are developing a mobile app for fantasy basketball enthusiasts, you might want to display the active players on WNBA teams. This feature allows users to make informed decisions for their fantasy drafts and team management by providing up-to-date information on which players are currently active and eligible to score points in upcoming games.

The following is an example of how you can display a team roster on your platform, showcasing key details such as player names, jersey numbers, positions, age, height, and weight.

📸

Accessing Headshots and Team Logos

To access team logos and player headshots, use the Images API.

👍

Tip - Utilize Team Franchise Data

You can also use the Team Roster and Team Profile endpoints to access detailed franchise data for WNBA teams. This information includes the team's founding year, current owner, nicknames, records of championships and division titles won and more.

How do I get the most up-to-date game roster for each team?

You may want to check the status of players for each team for a specific game to better understand team strategies and predict game outcomes:

  1. Get the Game ID for the desired game - Find the game ID by querying one of the following feeds:
    1. Schedule
    2. Daily Schedule
  2. Use the Game Summary feed to access data on player statuses for the game.

Game Summary Update Frequency and Recommended Retrieval Times

  • Player statuses are updated between 45 and 60 minutes before the game starts. Further changes may occur as the team provides additional information to the head table.
  • If player status data is your primary interest, you can request it then. Typically, you should request this feed no sooner than 10 minutes before the game's scheduled start time (status = "scheduled"), depending on your specific needs.
  • Once the game is in progress (status = "inprogress"), you may query the feed as necessary.
  • The endpoint offers real-time data updates and maintains a two-second TTL once the game status changes to inprogress.

Player Status Examples using the Game Summary Feed

The Game Summary feed provides the status of players on each team's roster. For example, consider an active player (active=true) like Kia Nurse during a specific game:

<player full_name="Kia Nurse" jersey_number="10" id="c0d2573a-fc13-405d-bb9e-cc37552806ed" first_name="Kia" last_name="Nurse" position="F" primary_position="SF" played="true" active="true" starter="true" on_court="true" sr_id="sr:player:1155250" reference="1628915">

You can track data points like active, played, andon_court, to determine the if the player is on the game's active roster and whether or not they played.

You can also track players who are not part of the active roster (active="false"), such as Anthony Davis, who is not participating in this game.

Note: The active Boolean will not display in the response if set to false.

<player full_name="Azurá Stevens" jersey_number="23" id="1ed5a0c9-ad93-4996-acca-94c7e301bb79" first_name="Azurá" last_name="Stevens" position="F-C" primary_position="NA" not_playing_reason="Inactive - Injury/Illness" not_playing_description="Left Arm" on_court="false" sr_id="sr:player:1152696" reference="1628922">

Data points like not_playing_reason and not_playing_description can help you better understand why a player is not active and did not play for a game.

Why does a player have a status of active=true alongside a not_playing_reason?

Players can be declared as part of the 12-person active roster for a game but still not participate. Consider Emily Engstler as an example:

<player full_name="Emily Engstler" jersey_number="21" id="7c76cfae-0b68-4449-9a96-73d271fbc32e" first_name="Emily" last_name="Engstler" position="F" primary_position="NA" active="true" not_playing_reason="DNP – Coach's Decision" on_court="false" sr_id="sr:player:1617710" reference="1631083">

In this instance, Engstler's status is set to active="true", indicating she is one of the 12 designated active players for the game. However, her not_playing_reason is DNP – Coach's Decision, meaning she did not play for the game due to her coach.

🚧

In-Game Injuries and Player Status

In-game injuries do not affect player status updates.



Team vs. Game Roster Statuses

Team Roster Statuses

The status data point indicates a player’s current status with their team. For example, in the Team Profile endpoint, a player’s status might show as active (ACT), suspended (SUS), or injured (IR)

Active (ACT) on the team roster indicates a player's general inclusion on the team's active roster, regardless of their participation for a specific game.

  • WNBA teams maintain a 12-player roster, with all 12 typically eligible to be active for each game.
  • Injured or suspended players may remain on the active roster unless subject to waivers or specific designations.
  • Example: A player is apart of a team's active roster but not playing a specific game due to an injury.

For the complete list of status values for team rosters, refer to our WNBA FAQs .

Game Roster Statuses

A game specific Boolean attribute called active is used to denote a player's status for a specific game. You can retrieve this status using the Game Summary endpoint.

  • This is a team decision made before each game — typically all 12 players from the full roster can be designated as active (active="true") for a given game unless they are injured, suspended, or on leave.
  • If a player is not part of the game’s 12-player active list, they are considered inactive for the game (active="false"). Note that this Boolean will not appear in the response if it is set to false.
  • The team must mark players as “active” or “inactive” for a specific game, which is separate from their overall roster status.
  • Starter and Player Participation Statuses
    • Starters (starter="true") populate ~45 minutes prior to the start of a game.
    • Player participation (played="true") updates for starters ~45 minutes prior to game start, and for the other players as they appear in the game.

🏀

Designating Player Statuses

There is no league requirement to formally designate a set number of active players before each game.


Position on the Court

Primary Position

Since basketball positions can be more fluid than in sports like football or hockey, with players often switching roles during a game, we use primary_position to highlight a player’s main role on the court.

This designation focuses on key positions: PG (Point Guard), SG (Shooting Guard), SF (Small Forward), PF (Power Forward), or C (Center). You can find this data in the following feeds:

  • Daily Transfers
  • Free Agents
  • Game Boxscore
  • Game Summary
  • Injuries
  • League Leaders
  • Player Profile
  • Seasonal Statistics
  • Team Profile
  • Push Statistics

You’ll typically see Primary Position added closer to the start of the season, once there’s more information about what position the player will play or has already played in the WNBA. Thus, primary position for rookies may not be finalized until just before the season begins.

Position

Position is a broader term used to distinguish between frontcourt and backcourt players. This information is provided directly by the NBA, and as their official partner, we maintain consistency with the league’s designations.

Some players may switch between SF, PF, or C depending on the lineup. In these cases, you might opt to use the position field as "F-C" for simplicity, as it's more concise than listing "SF-PF-C."

See this FAQ for a complete list of player positions available.



Transactions

WNBA transactions refer to the movements of players between teams through trades, free agency signings, releases, or waivers.

Trades vs. Signings
  • Trades: Involves teams exchanging players, draft picks, or other assets. Both teams must agree to the trade, and players move between teams immediately once the trade is finalized.

  • Signings: Occur when a team adds a free agent (a player not currently signed to any team) to their roster. Signings can happen anytime a player is available and can include contract negotiations.

🚧

WNBA Draft Feed Availability

WNBA Draft feeds are not currently available. You can, however, track the NBA Draft using our existing NBA Draft feeds.

🏀

Waiving Players

In the WNBA, “waiving” a player refers to the process of releasing them from the team’s roster. Once waived, the player enters the waiver wire and can be claimed by another team under the terms of their existing contract. If unclaimed after 48 hours, the player becomes an unrestricted free agent. This process enables roster flexibility and gives other teams the opportunity to add experienced or emerging talent.

How to Access Transactions: You can access daily transaction updates using the Daily Transfers feed, which provides details of all transactions added or edited throughout each league-defined day.

How Transactions are Monitored and Updated
  • Once reputable sources have sourced a trade, our team will process the trade.
  • WNBA transactions happen year-round, with the quietest stretch typically between the end of the Finals in October and the start of Free Agency in January. Outside of that, player movement—including trades, signings, and hardship contracts—occurs regularly throughout the year.
Recommended Pull Frequency
  • The feed updates in real-time as transactions occur.
  • Depending on your needs, you might consider pulling data hourly.
  • The TTL for this feed is 300 seconds.

👍

Tip - Track Effective Dates

To ensure accuracy in tracking player movements, always check the effective_date in transaction data as it specifies when changes officially take place.

Daily Transfers Response Example
{
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "start_time": "2024-05-07T04:00:00Z",
  "end_time": "2024-05-08T03:59:59Z",
  "players": [
    {
      "id": "0b0bd0b5-9605-4e68-9906-652cf72a9864",
      "full_name": "Angel Jackson",
      "first_name": "Angel",
      "last_name": "Jackson",
      "position": "C",
      "primary_position": "NA",
      "sr_id": "sr:player:2272777",
      "transfers": [
        {
          "id": "81ec2bd9-0eb2-4d01-8c11-fe69202efe6c",
          "desc": "The Las Vegas Aces waived C Angel Jackson.",
          "effective_date": "2024-05-07",
          "last_modified": "2024-05-07T17:33:28Z",
          "transaction_type": "Waived",
          "transaction_code": "WA",
          "from_team": {
            "id": "171b097d-01db-4ae8-9d56-035689402ec6",
            "name": "Aces",
            "market": "Las Vegas",
            "reference": "1611661319"
          }
        }
      ]
    },
    {
      "id": "8e1615b7-c8ef-46d5-90be-3b9ccf15daa4",
      "full_name": "Khaalia Hillsman",
      "first_name": "Khaalia",
      "last_name": "Hillsman",
      "position": "C",
      "primary_position": "NA",
      "sr_id": "sr:player:1148278",
      "reference": "1628949",
      "transfers": [
        {
          "id": "cbd1bd87-20fc-473c-846c-2b806d47b521",
          "desc": "The Atlanta Dream have waived C Khaalia Hillsman.",
          "effective_date": "2024-05-07",
          "last_modified": "2024-05-07T22:03:28Z",
          "transaction_type": "Waived",
          "transaction_code": "WA",
          "from_team": {
            "id": "5d70a9af-8c2b-4aec-9e68-9acc6ddb93e4",
            "name": "Dream",
            "market": "Atlanta",
            "reference": "1611661330"
          }
        }
      ]
    },
    {
      "id": "9659fad4-96be-46ab-9fc7-cec258570e5d",
      "full_name": "Queen Egbo",
      "first_name": "Queen",
      "last_name": "Egbo",
      "position": "F-C",
      "primary_position": "NA",
      "jersey_number": "4",
      "sr_id": "sr:player:2331805",
      "reference": "1631031",
      "transfers": [
        {
          "id": "ce9f1dab-27df-46a5-89a8-f9d2a45dfb78",
          "desc": "The Connecticut Sun acquired F-C Queen Egbo in a trade.",
          "effective_date": "2024-05-06",
          "last_modified": "2024-05-07T15:52:16Z",
          "transaction_type": "Traded",
          "transaction_code": "TRD",
          "from_team": {
            "id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
            "name": "Mystics",
            "market": "Washington",
            "reference": "1611661322"
          },
          "to_team": {
            "id": "a015b02d-845c-40c1-8ef4-844984f47e4d",
            "name": "Sun",
            "market": "Connecticut",
            "reference": "1611661323"
          }
        }
      ]
    },
    {
      "id": "bb53549e-943a-422c-848a-987d237caa52",
      "full_name": "Bernadett Hatar",
      "first_name": "Bernadett",
      "last_name": "Hatar",
      "position": "C",
      "primary_position": "NA",
      "sr_id": "sr:player:2020063",
      "reference": "1630043",
      "transfers": [
        {
          "id": "87ea47bd-2329-46d2-ac0b-45d6d337b47d",
          "desc": "The Washington Mystics acquired C Bernadett Hatar in a trade.",
          "effective_date": "2024-05-06",
          "last_modified": "2024-05-07T15:50:47Z",
          "transaction_type": "Traded",
          "transaction_code": "TRD",
          "from_team": {
            "id": "a015b02d-845c-40c1-8ef4-844984f47e4d",
            "name": "Sun",
            "market": "Connecticut",
            "reference": "1611661323"
          },
          "to_team": {
            "id": "5c0d47fe-8539-47b0-9f36-d0b3609ca89b",
            "name": "Mystics",
            "market": "Washington",
            "reference": "1611661322"
          }
        }
      ]
    }
  ]
}

This code sample demonstrates how to use the WNBA transaction feed to monitor player movement across the league. It includes real-time updates on player transactions such as trades and waivers. For example, Queen Egbo was traded from the Washington Mystics to the Connecticut Sun, while players like Angel Jackson and Khaalia Hillsman were waived by the Aces and Dream, respectively. Each entry captures essential details such as the player’s name, position, transaction type (e.g., Traded or Waived), the teams involved, and the effective date. This data enables you to build tools that track roster changes and team updates throughout the season.

Daily Transfers Use Case

As a developer working on a sports news aggregation app, you can use this feed to provide real-time updates on player moves and status changes directly on your platform. This keeps your users informed with the latest happenings in the league, especially during the active trading and signing periods. For example, you could highlight major transactions like trades, signings, or injury-related changes, enhancing the timeliness and relevance of the content on your app.

🏀

Transaction and Code Types

For the full list of transaction and code types, visit our WNBA FAQs.

Free Agents

In the WNBA, free agents are players who are not currently under contract with any team, allowing them to sign with any team of their choosing. The Free Agents feed is dedicated to providing detailed player information for all current free agents in the league.

Recommended Pull Frequency
  • Updates are made in realtime as changes are made to rosters or player profiles.
  • Pull every hour or less depending on your use case.
  • The TTL for this feed is 300 seconds.
Free Agents Response Example
{
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "free_agents": [
    {
      "id": "002295a0-fed1-47a7-af34-62724ea4b18a",
      "status": "FA",
      "full_name": "Aliyyah Handford",
      "first_name": "Aliyyah",
      "last_name": "Handford",
      "abbr_name": "A.Handford",
      "height": 69,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "college": "St. John's",
      "high_school": "Shabazz (NJ)",
      "birth_place": "Newark, NJ, USA",
      "birthdate": "1994-08-09",
      "updated": "2023-04-26T16:38:07Z"
    },
    {
      "id": "02050dcc-ca6d-4e7d-91de-c27d4bdb5573",
      "status": "FA",
      "full_name": "Jailin Cherry",
      "first_name": "Jailin",
      "last_name": "Cherry",
      "abbr_name": "J.Cherry",
      "height": 68,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "college": "LSU",
      "high_school": "Pascagoula (MS)",
      "birth_place": "Pascagoula, MS, USA",
      "birthdate": "1999-07-13",
      "updated": "2022-04-11T14:07:22Z"
    },
    {
      "id": "02467360-fdff-4499-b198-5f2d82aae426",
      "status": "FA",
      "full_name": "Porsha Roberts",
      "first_name": "Porsha",
      "last_name": "Roberts",
      "abbr_name": "P.Roberts",
      "height": 74,
      "position": "C",
      "primary_position": "NA",
      "experience": "0",
      "college": "Stephen F. Austin",
      "high_school": "La Vega (TX)",
      "birth_place": "Waco, TX, USA",
      "birthdate": "1993-02-26",
      "updated": "2023-04-25T18:51:06Z"
    },
    {
      "id": "02499b0d-4edc-47c8-ac28-cf75088110d6",
      "status": "FA",
      "full_name": "Kaylee Jensen",
      "first_name": "Kaylee",
      "last_name": "Jensen",
      "abbr_name": "K.Jensen",
      "height": 76,
      "position": "C",
      "primary_position": "NA",
      "experience": "0",
      "college": "Oklahoma State",
      "birth_place": "Wayne, NE, USA",
      "birthdate": "1996-07-27",
      "updated": "2018-05-17T22:58:14Z",
      "reference": "1628901"
    },
    {
      "id": "02588bee-d5db-44d0-8e1b-5aeb4f1c465d",
      "status": "FA",
      "full_name": "Ashton Millender",
      "first_name": "Ashton",
      "last_name": "Millender",
      "abbr_name": "A.Millender",
      "height": 68,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "college": "DePaul",
      "high_school": "Marian Catholic (IL)",
      "birth_place": "Glenwood, IL, USA",
      "updated": "2023-04-26T17:12:55Z",
      "sr_id": "sr:player:1148786",
      "reference": "1629593"
    },
    {
      "id": "033c5a47-698c-404f-9e3b-c814830aee9c",
      "status": "FA",
      "full_name": "Inga Orekhova",
      "first_name": "Inga",
      "last_name": "Orekhova",
      "abbr_name": "I.Orekhova",
      "height": 74,
      "weight": 160,
      "position": "G",
      "primary_position": "NA",
      "experience": "1",
      "college": "South Florida",
      "high_school": "The Bishop's School (CA)",
      "birth_place": "Sevastapol,, UKR",
      "birthdate": "1989-11-10",
      "updated": "2023-04-25T16:16:59Z",
      "rookie_year": 2014
    },
    {
      "id": "03bba927-8a04-474d-b9e0-a66ff59140a6",
      "status": "FA",
      "full_name": "Destiny Harden",
      "first_name": "Destiny",
      "last_name": "Harden",
      "abbr_name": "D.Harden",
      "height": 72,
      "position": "F",
      "primary_position": "NA",
      "experience": "0",
      "college": "Miami (FL)",
      "high_school": "Morgan Park (IL)",
      "birth_place": "Chicago, IL, USA",
      "birthdate": "1998-09-24",
      "updated": "2023-05-08T16:12:42Z",
      "sr_id": "sr:player:1322678"
    },
    {
      "id": "05af38d3-bf61-47f4-8366-8f4c8cdff491",
      "status": "FA",
      "full_name": "Promise Amukamara",
      "first_name": "Promise",
      "last_name": "Amukamara",
      "abbr_name": "P.Amukamara",
      "height": 68,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "college": "Arizona State",
      "high_school": "Apollo HS (AZ)",
      "birth_place": "Glendale, AZ, USA",
      "birthdate": "1993-07-15",
      "updated": "2020-03-26T15:07:44Z",
      "rookie_year": 2015
    },
    {
      "id": "05dd5651-2b41-4752-a3d0-77d7e80107bc",
      "status": "FA",
      "full_name": "Aleah Goodman",
      "first_name": "Aleah",
      "last_name": "Goodman",
      "abbr_name": "A.Goodman",
      "height": 69,
      "position": "G",
      "primary_position": "NA",
      "experience": "0",
      "college": "Oregon State",
      "high_school": "La Salle (OR)",
      "birth_place": "Milwaukie, OR, USA",
      "birthdate": "1998-11-24",
      "updated": "2021-05-17T19:04:01Z",
      "sr_id": "sr:player:2147090",
      "reference": "1630453"
    },
    {
      "id": "075888e0-4efc-4d52-8ea0-1943a87e8bfb",
      "status": "FA",
      "full_name": "Amanda Zahui B.",
      "first_name": "Amanda",
      "last_name": "Zahui B.",
      "abbr_name": "A.Zahui B.",
      "height": 76,
      "weight": 184,
      "position": "C",
      "primary_position": "NA",
      "experience": "7",
      "college": "Minnesota",
      "high_school": "Igelstavikens Gymnasium (SWE)",
      "birth_place": "Stockholm,, SWE",
      "birthdate": "1993-09-08",
      "updated": "2024-04-30T00:22:45Z",
      "sr_id": "sr:player:1156912",
      "rookie_year": 2015,
      "reference": "204320"
    },
    {
      "id": "07e0c644-8280-4e74-8546-0c9343f824e8",
      "status": "FA",
      "full_name": "Sugar Rodgers",
      "first_name": "Sugar",
      "last_name": "Rodgers",
      "abbr_name": "S.Rodgers",
      "height": 69,
      "weight": 161,
      "position": "G",
      "primary_position": "NA",
      "experience": "7",
      "college": "Georgetown",
      "high_school": "King's Fork (VA)",
      "birth_place": "Suffolk, VA, USA",
      "birthdate": "1989-12-08",
      "updated": "2021-01-07T21:44:38Z",
      "sr_id": "sr:player:1156794",
      "rookie_year": 2013,
      "reference": "203411"
    }
  ]
}

This code sample highlights how to retrieve and display free agent data from the WNBA. Each player entry includes identifying details such as player ID, full name, position, height, college, and professional experience. All players listed have a status of "FA" (free agent), indicating they are currently unsigned. For instance, Aliyyah Handford is a 5'9" guard from St. John’s with no WNBA experience, and her free agent status was last updated in April 2023. This data can be used to build applications that track unsigned players, support scouting efforts, or analyze roster availability throughout the year.

You can integrate the Free Agents feed into your application to track available players for potential team signings or roster updates.



Injury Data

Accessing injury data is crucial for managing WNBA rosters, as it helps teams assess player availability and make strategic decisions.

How to Access Injury Data: You can access injury data using two endpoints:

  1. The Injuries feed provides injuries information for all active player injuries for each WNBA team.
  2. The Daily Injuries feed provides a list of injured players for each team for a given day, including practice status. Please note, we do not provide live injuries.

🏀

What if a Player Is Listed as Out Prior to a Game?

Our roster team updates injury reports before games; however, players listed as questionable or expected to play may still not participate. To get the most accurate player status, it's best to check the game endpoints (PBP, Game Boxscore, and Game Summary) for real-time updates.

For the full list of values for player - not_playing_reason, visit our WNBA FAQs.

Recommended Pull Frequency
  • We monitor and update injuries throughout the day during the season, using a combination of official and reliable sources.
  • Pull every hour or less during the season, depending on your use case.
  • The TTL for this feed is 300 seconds.
Daily Injuries Response Example
{
  "league": {
    "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
    "name": "WNBA",
    "alias": "WNBA"
  },
  "date": "2024-09-18",
  "teams": [
    {
      "id": "0a5ad38d-2fe3-43ba-894b-1ba3d5042ea9",
      "name": "Sparks",
      "market": "Los Angeles",
      "franchise_id": "2e4e5ff6-1dcf-4126-aecd-b48e579ff82c",
      "sr_id": "sr:team:3447",
      "reference": "1611661320",
      "players": [
        {
          "id": "612e128c-c5b3-4ce0-a131-ce4d10f4f7ff",
          "full_name": "Aari McDonald",
          "first_name": "Aari",
          "last_name": "McDonald",
          "position": "G",
          "primary_position": "NA",
          "jersey_number": "15",
          "sr_id": "sr:player:1148502",
          "reference": "1630462",
          "injuries": [
            {
              "id": "b0333b13-da4b-4fa7-aa50-c4cd434bac95",
              "comment": "McDonald has been ruled out for Thursday's regular-season finale against the Lynx, Rey Moralde of The Sporting Tribune reports.",
              "desc": "Ankle",
              "status": "Out",
              "start_date": "2024-09-18",
              "update_date": "2024-09-18"
            }
          ]
        },
        {
          "id": "155215e8-3e76-49cd-b00a-e0d9a124ec7f",
          "full_name": "Lexie Brown",
          "first_name": "Lexie",
          "last_name": "Brown",
          "position": "G",
          "primary_position": "NA",
          "jersey_number": "4",
          "sr_id": "sr:player:1151590",
          "reference": "1628882",
          "injuries": [
            {
              "id": "c797b71a-3eaf-47e7-ad26-179b35db6c04",
              "comment": "Brown has been ruled out for Thursday's (Sept. 19) regular-season finale against Minnesota, Rey Moralde of The Sporting Tribune reports.",
              "desc": "Illness",
              "status": "Out",
              "start_date": "2024-06-27",
              "update_date": "2024-09-18"
            }
          ]
        }
      ]
    }
  ]
}

This JSON code sample delivers injury report data for WNBA players, organized by team, for games scheduled on September 18, 2024. It includes injury status updates for players like Aari McDonald and Lexie Brown of the Los Angeles Sparks. Each entry outlines the injury type (e.g., ankle, illness), player status (e.g., Out), and the latest update date. This dataset supports use cases in fantasy platforms, sports betting, and fan engagement apps by offering real-time insights into player availability and team health.


What Injury Statuses Can I Expect to See?

  • Unknown
  • Day to Day
  • Out
  • Out for Season
  • Out Indefinitely
<injuries>
    <injury id="1805a44b-1b17-42e7-a26a-5270882d4248" comment="McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans." 
		desc="Knee" status="Day To Day" start_date="2023-11-07" update_date="2023-11-08"/>
</injuries>
"injuries": [
  {
    "id": "1805a44b-1b17-42e7-a26a-5270882d4248",
    "comment": "McLaughlin did not play in Wednesday's (Nov.8) game against New Orleans.",
    "desc": "Knee",
    "status": "Day To Day",
    "start_date": "2023-11-07",
    "update_date": "2023-11-08"
  }
]



Daily Change Log

The Daily Change Log endpoint provides an efficient way to monitor daily updates within the WNBA API, including roster adjustments, transactions, and corrections to player injury details, without exhausting your API call quota.

The table below outlines scenarios and use cases for utilizing the Daily Change Log based on team roster and player updates.

Steps to monitor roster updates:

  1. Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.

  2. Use IDs to Retrieve Specifics: IDs associated with players or teams indicate changes relevant to these entities, such as updates to team rosters.

  3. Pull Detailed Data: Use the identified IDs to pull detailed information from the Team Profile feed.

  4. Verify Changes: After pulling the data, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates:

  • Entries populate live for changes to teams, players, game statistics, schedules, and standings.
  • Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC

For optimal results, set a regular schedule to pull every 10 minutes or less (depending on your use case) to access the feed.