Retrieve a list of players with optional pagination and filtering.
Description
Get a paginated list of all players. This endpoint will return only active teams, so if a player retired or is not currently on a roster, that player will no longer be active for that league.
Player IDs are unique per league, this means that the same player can have different IDs across leagues. For example, Lionel Messi has the following IDs:
C7231134C08F: USA - Major League Soccer7D915F8BDA8E: CONMEBOL - Copa America
If a player is no longer active but you want to get information about it, you can pass in the id to this endpoint and it will return data for inactive players.
Specific Parameter Information
For a full list of parameters, scroll to the bottom of this page.
You must pass at least one of the following (sport, league, id).
sport
The sport you want to get fixtures for. You can pass the id or the name.
league
The league you want to get fixtures for. You can pass the id or the name.
id
The id of the team you want information for.
include_statsperform_id
Specify this parameter if you want the StatsPerform IDs to be included as part of the response. If this is enabled, you will see it populated in the source_ids field of the Fixture entry:
"source_ids": {
"statsperform_id": "a2nwp4zx1mzcmk2e4dtcw5h5g"
}
Example Responses
ONLY USED TO SHOW AN EXAMPLE JSON FORMAT, DATA CAN BE DIFFERENT FROM ACTUAL RESPONSE
NFL
URL: https://api.opticodds.com/api/v3/players?league=NFL
{
"data": [
{
"id": "58528E9A72E6",
"name": "Aaron Banks",
"position": "G",
"number": 65,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Banks",
"age": 27,
"height": 76,
"weight": 323,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1559.png",
"base_id": 1559,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "132B64CEDAC4",
"name": "San Francisco 49ers",
"numerical_id": null
}
},
{
"id": "E1C6CF8263C2",
"name": "Aaron Brewer",
"position": "G",
"number": 55,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Brewer",
"age": 27,
"height": 72,
"weight": 292,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1560.png",
"base_id": 1560,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "8380A12E67FE",
"name": "Miami Dolphins",
"numerical_id": null
}
},
{
"id": "26715A178473",
"name": "Aaron Brewer",
"position": "LS",
"number": 46,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Brewer",
"age": 34,
"height": 76,
"weight": 231,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1561.png",
"base_id": 1561,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "AF456B375E7E",
"name": "Arizona Cardinals",
"numerical_id": null
}
},
{
"id": "6A8C12F44A16",
"name": "Aaron Jones",
"position": "RB",
"number": 33,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Jones",
"age": 30,
"height": 68,
"weight": 206,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1564.png",
"base_id": 1564,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "24E4EA618C5E",
"name": "Minnesota Vikings",
"numerical_id": null
}
},
{
"id": "16E7FD97D946",
"name": "Aaron Rodgers",
"position": "QB",
"number": 8,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Rodgers",
"age": 41,
"height": 73,
"weight": 222,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1566.png",
"base_id": 1566,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "032D4F9C6C55",
"name": "New York Jets",
"numerical_id": null
}
},
{
"id": "8C27E3A10D7A",
"name": "Aaron Shampklin",
"position": "RB",
"number": 33,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Shampklin",
"age": 25,
"height": 69,
"weight": 193,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1567.png",
"base_id": 1567,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "727B3B3C78E8",
"name": "Pittsburgh Steelers",
"numerical_id": null
}
},
{
"id": "15D6D87D37FB",
"name": "Aaron Stinnie",
"position": "G",
"number": 64,
"numerical_id": null,
"is_active": true,
"first_name": "Aaron",
"last_name": "Stinnie",
"age": 30,
"height": 74,
"weight": 310,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1568.png",
"base_id": 1568,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "ACC49FC634EE",
"name": "New York Giants",
"numerical_id": null
}
},
{
"id": "233712626CE6",
"name": "Abdullah Anderson",
"position": "DT",
"number": 94,
"numerical_id": null,
"is_active": true,
"first_name": "Abdullah",
"last_name": "Anderson",
"age": 29,
"height": 75,
"weight": 292,
"experience": null,
"logo": "https://cdn.opticodds.com/player-logos/football/1569.png",
"base_id": 1569,
"source_ids": {
},
"sport": {
"id": "football",
"name": "Football",
"numerical_id": 9
},
"league": {
"id": "nfl",
"name": "NFL",
"numerical_id": 367
},
"team": {
"id": "24988863B4CB",
"name": "Tennessee Titans",
"numerical_id": null
}
},
...
]
}