Events API

Player

GET/v1/player

Player profile, transfers and match lines.

Parameters

Send every parameter in the query string, including token.

Query parameters
Name	Type	Required	Description
token	string	Required	Your API token.
player_id	string	Required	Player id from Team Squad etc.

Notes

transfers[].type_id: 1 player, 3 manager, 8 on loan.

Request

Call https://api.odds-data-api.com/v1/player with your token. The examples read it from the ODDS_DATA_API_TOKEN environment variable.

curl "https://api.odds-data-api.com/v1/player?player_id=1020401&token=$ODDS_DATA_API_TOKEN"

Response

JSON with success: 1 and results. Values are strings unless shown otherwise. See Response format and R-Pager.

application/json

{
  "success": 1,
  "results": {
    "player": {
      "id": "1020401",
      "name": "Tomás Silva",
      "cc": "gb",
      "birthdate": "1996-04-09",
      "position": "Goalkeeper",
      "height": "191",
      "weight": "85",
      "foot": "Right"
    },
    "transfers": [
      {
        "start": "1719792000",
        "end": "0",
        "type_id": "1",
        "active": "1",
        "team": {
          "id": "10204",
          "name": "Brentford",
          "image_id": null,
          "cc": "gb"
        }
      }
    ],
    "events": [
      {
        "starting": "1",
        "substitutedIn": "0",
        "substitutedOut": "0",
        "minutesplayed": "90",
        "goals": "0",
        "assists": "0",
        "yellowcard": "",
        "redcard": "",
        "shots": "0",
        "shots_on_goal": "0",
        "event": {
          "id": "8204771",
          "sport_id": "1",
          "league": {
            "id": "10041282",
            "name": "England Premier League",
            "cc": "gb"
          },
          "home": {
            "id": "10204",
            "name": "Brentford",
            "image_id": null,
            "cc": "gb"
          },
          "away": {
            "id": "10218",
            "name": "Everton",
            "image_id": null,
            "cc": "gb"
          },
          "time": "1789237200",
          "ss": "2-1",
          "time_status": "1"
        }
      }
    ]
  }
}

Errors

A failed call returns success: 0 with an error code. This endpoint can return:

Error codes
error	Meaning
NOT_FOUND	404 Not Found.
AUTHORIZE_FAILED	Token is not provided or is incorrect.
TOO_MANY_REQUESTS	API rate limit exceeded. See X-RateLimit-Reset.
PERMISSION_DENIED	Your plan does not include this call. Contact support if this is wrong.
PARAM_REQUIRED	A required param is missing. Check error_detail.
PARAM_INVALID	A param is invalid. Check error_detail.

Failed call · application/json

{
  "success": 0,
  "error": "PARAM_REQUIRED",
  "error_detail": "player_id"
}

Like every endpoint, it can also return INTERNAL_SERVER_ERROR, METHOD_NOT_ALLOWED and UNDER_MAINTENANCE. See R-Errors.

Try it

GEThttps://api.odds-data-api.com/v1/player?player_id=1020401&token=YOUR-TOKEN

player_id: 1020401
token: YOUR-TOKEN (from the dashboard)

Requests run with your own token and count toward your hourly limit.