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 Soccer
7D915F8BDA8E : 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
      }
    },
    ...
  ]
}