WNBA API

Welcome to the BALLDONTLIE WNBA API, the best WNBA API on the planet. The API contains data from 2008-current. An API key is required. You can obtain an API key by creating a free account on our website. Read the authentication section to learn how to use the API key.

Take a look at our other APIs:

Join us on discord.

MCP Server Integration

Connect to our sports data through any MCP-compatible client using our hosted MCP server. The MCP (Model Context Protocol) server allows AI assistants to interact with our API through natural language.

Quick Setup

Add this configuration to your MCP client (e.g., Claude Desktop, or any other MCP-compatible client):

{
  "mcpServers": {
    "balldontlie-api": {
      "url": "https://mcp.balldontlie.io/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "YOUR_BALLDONTLIE_API_KEY"
      }
    }
  }
}

Open Source Implementation

Check out our open-source MCP server implementation on GitHub: https://github.com/balldontlie-api/mcp

Usage Examples

Once configured, you can ask your AI assistant natural language questions like:

"Get the current WNBA standings"
"Show me Caitlin Clark's season stats"
"What are today's WNBA games?"

The MCP server provides access to all available API endpoints through conversational AI, making it easy to integrate sports data into any AI-powered application.

Account Tiers

There are three different account tiers which provide you access to different types of data. Visit our website to create an account for free.

Paid tiers do not apply across sports. The tier you purchase for NBA will not automatically be applied to other sports. You can purchase the ALL-ACCESS ($89.99/mo) tier to get access to every endpoint for every sport.

Read the table below to see the breakdown.

Endpoint	Free	ALL-STAR	GOAT
Teams	Yes	Yes	Yes
Players	Yes	Yes	Yes
Games	Yes	Yes	Yes
Active Players	No	Yes	Yes
Player Injuries	No	Yes	Yes
Standings	No	Yes	Yes
Play-by-Play	No	Yes	Yes
Player Stats	No	No	Yes
Team Stats	No	No	Yes
Player Season Stats	No	No	Yes
Team Season Stats	No	No	Yes

The feature breakdown per tier is shown in the table below.

Tier	Requests / Min	$USD / mo.
GOAT	600	39.99
ALL-STAR	60	9.99
Free	5	0

Authentication

curl "api_endpoint_here" -H "Authorization: YOUR_API_KEY"

BALLDONTLIE uses API keys to allow access to the API. You can obtain an API key by creating a free account at our website

We expect the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: YOUR_API_KEY

You must replace YOUR_API_KEY with your personal API key.

Pagination

This API uses cursor based pagination rather than limit/offset. Endpoints that support pagination will send back responses with a meta key that looks like what is displayed on the right.

{
  "meta": {
    "next_cursor": 90,
    "per_page": 25
  }
}

You can use per_page to specify the maximum number of results. It defaults to 25 and doesn't allow values larger than 100.

You can use next_cursor to get the next page of results. Specify it in the request parameters like this: ?cursor=NEXT_CURSOR.

Errors

The API uses the following error codes:

Error Code	Meaning
401	Unauthorized - You either need an API key or your account tier does not have access to the endpoint.
400	Bad Request -- The request is invalid. The request parameters are probably incorrect.
404	Not Found -- The specified resource could not be found.
406	Not Acceptable -- You requested a format that isn't json.
429	Too Many Requests -- You're rate limited.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Teams

Get All Teams

curl "https://api.balldontlie.io/wnba/v1/teams" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "id": 1,
      "conference": "Eastern Conference",
      "city": "New York",
      "name": "Liberty",
      "full_name": "New York Liberty",
      "abbreviation": "NY"
    },
    {
      "id": 2,
      "conference": "Eastern Conference",
      "city": "Connecticut",
      "name": "Sun",
      "full_name": "Connecticut Sun",
      "abbreviation": "CON"
    }
    ...
  ]
}

This endpoint retrieves all WNBA teams.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/teams

Query Parameters

Parameter	Required	Description
conference	false	Returns teams that belong to this conference (Eastern or Western)

Players

Get All Players

curl "https://api.balldontlie.io/wnba/v1/players" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "id": 708,
      "first_name": "Caitlin",
      "last_name": "Clark",
      "position": "G",
      "position_abbreviation": "G",
      "height": "6' 0\"",
      "weight": "157 lbs",
      "jersey_number": "22",
      "college": "Iowa",
      "age": 23,
      "team": {
        "id": 3,
        "conference": "Eastern Conference",
        "city": "Indiana",
        "name": "Fever",
        "full_name": "Indiana Fever",
        "abbreviation": "IND"
      }
    }
    ...
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves all WNBA players.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/players

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
search	false	Returns players whose first or last name matches this value. For example, `?search=clark` will return players that have 'clark' in their first or last name.
first_name	false	Returns players whose first name matches this value. For example, `?first_name=caitlin` will return players that have 'caitlin' in their first name.
last_name	false	Returns players whose last name matches this value. For example, `?last_name=clark` will return players that have 'clark' in their last name.
team_ids	false	Returns players that belong to these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
player_ids	false	Returns players that match these ids. This should be an array: `?player_ids[]=1&player_ids[]=2`

Get a Specific Player

curl "https://api.balldontlie.io/wnba/v1/players/<ID>" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": {
    "id": 708,
    "first_name": "Caitlin",
    "last_name": "Clark",
    "position": "G",
    "position_abbreviation": "G",
    "height": "6' 0\"",
    "weight": "157 lbs",
    "jersey_number": "22",
    "college": "Iowa",
    "age": 23,
    "team": {
      "id": 3,
      "conference": "Eastern Conference",
      "city": "Indiana",
      "name": "Fever",
      "full_name": "Indiana Fever",
      "abbreviation": "IND"
    }
  }
}

This endpoint retrieves a specific WNBA player.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/players/<ID>

URL Parameters

Parameter	Required	Description
ID	true	The ID of the player to retrieve

Get Active Players

curl "https://api.balldontlie.io/wnba/v1/players/active" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "id": 251,
      "first_name": "Tina",
      "last_name": "Charles",
      "position": "C",
      "position_abbreviation": "C",
      "height": "6' 4\"",
      "weight": "192 lbs",
      "jersey_number": "31",
      "college": "UConn",
      "age": 36,
      "team": {
        "id": 2,
        "conference": "Eastern Conference",
        "city": "Connecticut",
        "name": "Sun",
        "full_name": "Connecticut Sun",
        "abbreviation": "CON"
      }
    }
    ...
  ],
  "meta": {
    "next_cursor": 25,
    "per_page": 25
  }
}

This endpoint retrieves all currently active WNBA players.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/players/active

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
search	false	Returns players whose first or last name matches this value. For example, `?search=clark` will return players that have 'clark' in their first or last name.
first_name	false	Returns players whose first name matches this value. For example, `?first_name=caitlin` will return players that have 'caitlin' in their first name.
last_name	false	Returns players whose last name matches this value. For example, `?last_name=clark` will return players that have 'clark' in their last name.
team_ids	false	Returns players that belong to these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
player_ids	false	Returns players that match these ids. This should be an array: `?player_ids[]=1&player_ids[]=2`

Games

Get All Games

curl "https://api.balldontlie.io/wnba/v1/games" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "id": 4167,
      "date": "2025-10-05T19:00:00.000Z",
      "season": 2025,
      "postseason": true,
      "status": "post",
      "period": 4,
      "time": "0.0",
      "home_team": {
        "id": 8,
        "conference": "Western Conference",
        "city": "Las Vegas",
        "name": "Aces",
        "full_name": "Las Vegas Aces",
        "abbreviation": "LV"
      },
      "visitor_team": {
        "id": 10,
        "conference": "Western Conference",
        "city": "Phoenix",
        "name": "Mercury",
        "full_name": "Phoenix Mercury",
        "abbreviation": "PHX"
      },
      "home_score": 91,
      "away_score": 78
    }
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves all WNBA games.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/games

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
dates	false	Returns games that match these dates. Dates should be formatted in `YYYY-MM-DD`. This should be an array: `?dates[]=2024-05-15&dates[]=2024-05-16`
seasons	false	Returns games that occurred in these seasons. This should be an array: `?seasons[]=2023&seasons[]=2024`
team_ids	false	Returns games for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
season_type	false	Filter by season type (2 for regular season and 3 for postseason)
start_date	false	Returns games that occurred on or after this date. Date should be formatted in `YYYY-MM-DD`
end_date	false	Returns games that occurred on or before this date. Date should be formatted in `YYYY-MM-DD`

Player Stats

Get Player Statistics

curl "https://api.balldontlie.io/wnba/v1/player_stats" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "player": {
        "id": 373,
        "first_name": "Alyssa",
        "last_name": "Thomas",
        "position": "Forward",
        "position_abbreviation": "F",
        "height": null,
        "weight": null,
        "jersey_number": "25",
        "college": null,
        "age": null
      },
      "team": {
        "id": 10,
        "conference": "Western Conference",
        "city": "Phoenix",
        "name": "Mercury",
        "full_name": "Phoenix Mercury",
        "abbreviation": "PHX"
      },
      "game": {
        "id": 4167,
        "date": "2025-10-05T19:00:00.000Z",
        "season": 2025
      },
      "min": "30",
      "fgm": 5,
      "fga": 9,
      "fg3m": null,
      "fg3a": null,
      "ftm": null,
      "fta": null,
      "oreb": 3,
      "dreb": 3,
      "reb": 6,
      "ast": 5,
      "stl": 3,
      "blk": null,
      "turnover": 3,
      "pf": 4,
      "pts": 10,
      "plus_minus": -13
    },
    {
      "player": {
        "id": 633,
        "first_name": "Natasha",
        "last_name": "Mack",
        "position": "Forward",
        "position_abbreviation": "F",
        "height": null,
        "weight": null,
        "jersey_number": "8",
        "college": null,
        "age": null
      },
      "team": {
        "id": 10,
        "conference": "Western Conference",
        "city": "Phoenix",
        "name": "Mercury",
        "full_name": "Phoenix Mercury",
        "abbreviation": "PHX"
      },
      "game": {
        "id": 4167,
        "date": "2025-10-05T19:00:00.000Z",
        "season": 2025
      },
      "min": "19",
      "fgm": 3,
      "fga": 3,
      "fg3m": null,
      "fg3a": null,
      "ftm": null,
      "fta": null,
      "oreb": 2,
      "dreb": 8,
      "reb": 10,
      "ast": null,
      "stl": 1,
      "blk": 1,
      "turnover": null,
      "pf": 1,
      "pts": 6,
      "plus_minus": 4
    }
    ...
  ],
  "meta": {
    "next_cursor": 25,
    "per_page": 25
  }
}

This endpoint retrieves player game statistics.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/player_stats

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
player_ids	false	Returns stats for these player ids. This should be an array: `?player_ids[]=1&player_ids[]=2`
team_ids	false	Returns stats for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
game_ids	false	Returns stats for these game ids. This should be an array: `?game_ids[]=1&game_ids[]=2`
dates	false	Returns stats that match these dates. Dates should be formatted in `YYYY-MM-DD`. This should be an array: `?dates[]=2024-05-15&dates[]=2024-05-16`
seasons	false	Returns stats that occurred in these seasons. This should be an array: `?seasons[]=2023&seasons[]=2024`
start_date	false	Returns stats that occurred on or after this date. Date should be formatted in `YYYY-MM-DD`
end_date	false	Returns stats that occurred on or before this date. Date should be formatted in `YYYY-MM-DD`

Team Stats

Get Team Statistics

curl "https://api.balldontlie.io/wnba/v1/team_stats" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "team": {
        "id": 10,
        "conference": "Western Conference",
        "city": "Phoenix",
        "name": "Mercury",
        "full_name": "Phoenix Mercury",
        "abbreviation": "PHX"
      },
      "game": {
        "id": 4167,
        "date": "2025-10-05T19:00:00.000Z",
        "season": 2025
      },
      "fgm": 29,
      "fga": 71,
      "fg_pct": 40.8,
      "fg3m": 5,
      "fg3a": 28,
      "fg3_pct": 17.9,
      "ftm": 15,
      "fta": 18,
      "ft_pct": 83.3,
      "oreb": 8,
      "dreb": 26,
      "reb": 34,
      "ast": 17,
      "stl": 9,
      "blk": 1,
      "turnovers": 11,
      "fouls": 14
    },
    {
      "team": {
        "id": 8,
        "conference": "Western Conference",
        "city": "Las Vegas",
        "name": "Aces",
        "full_name": "Las Vegas Aces",
        "abbreviation": "LV"
      },
      "game": {
        "id": 4167,
        "date": "2025-10-05T19:00:00.000Z",
        "season": 2025
      },
      "fgm": 37,
      "fga": 75,
      "fg_pct": 49.3,
      "fg3m": 8,
      "fg3a": 23,
      "fg3_pct": 34.8,
      "ftm": 9,
      "fta": 13,
      "ft_pct": 69.2,
      "oreb": 9,
      "dreb": 34,
      "reb": 43,
      "ast": 21,
      "stl": 9,
      "blk": 6,
      "turnovers": 13,
      "fouls": 15
    }
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves team game statistics.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/team_stats

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
team_ids	false	Returns stats for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
game_ids	false	Returns stats for these game ids. This should be an array: `?game_ids[]=1&game_ids[]=2`
dates	false	Returns stats that match these dates. Dates should be formatted in `YYYY-MM-DD`. This should be an array: `?dates[]=2024-05-15&dates[]=2024-05-16`
seasons	false	Returns stats that occurred in these seasons. This should be an array: `?seasons[]=2023&seasons[]=2024`
start_date	false	Returns stats that occurred on or after this date. Date should be formatted in `YYYY-MM-DD`
end_date	false	Returns stats that occurred on or before this date. Date should be formatted in `YYYY-MM-DD`

Player Season Stats

Get Player Season Statistics

curl "https://api.balldontlie.io/wnba/v1/player_season_stats" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "player": {
        "id": 708,
        "first_name": "Caitlin",
        "last_name": "Clark",
        "position": "G",
        "position_abbreviation": "G",
        "height": "6' 0\"",
        "weight": "157 lbs",
        "jersey_number": "22",
        "college": "Iowa",
        "age": 23,
        "team": {
          "id": 3,
          "conference": "Eastern Conference",
          "city": "Indiana",
          "name": "Fever",
          "full_name": "Indiana Fever",
          "abbreviation": "IND"
        }
      },
      "team": {
        "id": 3,
        "conference": "Eastern Conference",
        "city": "Indiana",
        "name": "Fever",
        "full_name": "Indiana Fever",
        "abbreviation": "IND"
      },
      "season": 2025,
      "season_type": 2,
      "games_played": 13,
      "min": 31.08,
      "fgm": 5.54,
      "fga": 15.08,
      "fg_pct": 36.7,
      "fg3m": 2.23,
      "fg3a": 8,
      "fg3_pct": 27.9,
      "ftm": 3.15,
      "fta": 3.85,
      "ft_pct": 82,
      "reb": 5,
      "ast": 8.85,
      "stl": 1.62,
      "blk": 0.54,
      "turnover": 5.08,
      "pts": 16.46
    }
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves player season averages.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/player_season_stats

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
player_ids	false	Returns stats for these player ids. This should be an array: `?player_ids[]=1&player_ids[]=2`
team_ids	false	Returns stats for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
season	false	Filter by season
season_type	false	Filter by season type (2=regular, 3=playoffs)

Team Season Stats

Get Team Season Statistics

curl "https://api.balldontlie.io/wnba/v1/team_season_stats" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "team": {
        "id": 7,
        "conference": "Western Conference",
        "city": "Minnesota",
        "name": "Lynx",
        "full_name": "Minnesota Lynx",
        "abbreviation": "MIN"
      },
      "season": 2025,
      "season_type": 2,
      "games_played": 44,
      "fgm": 32.1,
      "fga": 68.1,
      "fg_pct": 47.2,
      "fg3m": 9.6,
      "fg3a": 25.4,
      "fg3_pct": 37.8,
      "ftm": 12.2,
      "fta": 16.1,
      "ft_pct": 76,
      "oreb": 8.5,
      "dreb": 25.6,
      "reb": 34.2,
      "ast": 23.3,
      "stl": 8.2,
      "blk": 4.8,
      "turnover": 12.1,
      "pts": 86.1
    }
    ...
  ],
  "meta": {
    "next_cursor": 25,
    "per_page": 25
  }
}

This endpoint retrieves team season statistics.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/team_season_stats

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
team_ids	false	Returns stats for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`
season	false	Filter by season
season_type	false	Filter by season type (2=regular, 3=playoffs)

Standings

Get League Standings

curl "https://api.balldontlie.io/wnba/v1/standings" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "team": {
        "id": 4,
        "conference": "Eastern Conference",
        "city": "Atlanta",
        "name": "Dream",
        "full_name": "Atlanta Dream",
        "abbreviation": "ATL"
      },
      "season": 2025,
      "conference": "Eastern Conference",
      "wins": 30,
      "losses": 14,
      "win_percentage": 0.682,
      "games_behind": 0,
      "home_record": "16-6",
      "away_record": "14-8",
      "conference_record": "15-6",
      "playoff_seed": 1
    },
    {
      "team": {
        "id": 1,
        "conference": "Eastern Conference",
        "city": "New York",
        "name": "Liberty",
        "full_name": "New York Liberty",
        "abbreviation": "NY"
      },
      "season": 2025,
      "conference": "Eastern Conference",
      "wins": 27,
      "losses": 17,
      "win_percentage": 0.614,
      "games_behind": 3,
      "home_record": "17-5",
      "away_record": "10-12",
      "conference_record": "15-5",
      "playoff_seed": 2
    }
    ...
  ]
}

This endpoint retrieves WNBA standings.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/standings

Query Parameters

Parameter	Required	Description
season	false	Filter by season
conference	false	Filter by conference (Eastern or Western)

Player Injuries

Get Player Injuries

curl "https://api.balldontlie.io/wnba/v1/player_injuries" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "player": {
        "id": 721,
        "first_name": "Angel",
        "last_name": "Reese",
        "position": "F",
        "position_abbreviation": "F",
        "height": "6' 3\"",
        "weight": "165 lbs",
        "jersey_number": "5",
        "college": "LSU",
        "age": 23,
        "team": {
          "id": 6,
          "conference": "Eastern Conference",
          "city": "Chicago",
          "name": "Sky",
          "full_name": "Chicago Sky",
          "abbreviation": "CHI"
        }
      },
      "status": "Out",
      "return_date": "May 1",
      "comment": "Sep 11: Reese (back) has been ruled out for Thursday's game against the Liberty."
    }
    ...
  ],
  "meta": {
    "next_cursor": 25,
    "per_page": 25
  }
}

This endpoint retrieves current player injury reports. It always returns live data and will never contain historical information.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/player_injuries

Query Parameters

Parameter	Required	Description
cursor	false	The cursor, used for pagination
per_page	false	The number of results per page. Default to 25. Max is 100
player_ids	false	Returns injuries for these player ids. This should be an array: `?player_ids[]=1&player_ids[]=2`
team_ids	false	Returns injuries for these team ids. This should be an array: `?team_ids[]=1&team_ids[]=2`

Play-by-Play

Get Play-by-Play Data

curl "https://api.balldontlie.io/wnba/v1/plays?game_id=1" \
  -H "Authorization: YOUR_API_KEY"

{
  "data": [
    {
      "game_id": 4167,
      "order": 1,
      "type": "Driving Layup Shot",
      "text": "Jewell Loyd blocks Sami Whitcomb 's 15-foot driving layup",
      "home_score": 21,
      "away_score": 21,
      "period": 1,
      "clock": "1:57",
      "scoring_play": false,
      "score_value": 0,
      "team": {
        "id": 10,
        "conference": "Western Conference",
        "city": "Phoenix",
        "name": "Mercury",
        "full_name": "Phoenix Mercury",
        "abbreviation": "PHX"
      }
    },
    {
      "game_id": 4167,
      "order": 2,
      "type": "Defensive Rebound",
      "text": "Jewell Loyd defensive rebound",
      "home_score": 21,
      "away_score": 21,
      "period": 1,
      "clock": "1:54",
      "scoring_play": false,
      "score_value": 0,
      "team": {
        "id": 8,
        "conference": "Western Conference",
        "city": "Las Vegas",
        "name": "Aces",
        "full_name": "Las Vegas Aces",
        "abbreviation": "LV"
      }
    }
  ]
}

This endpoint retrieves play-by-play data for a specific game.

HTTP Request

GET https://api.balldontlie.io/wnba/v1/plays

Query Parameters

Parameter	Required	Description
game_id	true	The game ID