Events API

League Table

GET/v3/league/table

Overall, home and away standings.

Parameters

Send every parameter in the query string, including token.

Query parameters
Name	Type	Required	Description
token	string	Required	Your API token.
league_id	string	Required	League id with has_leaguetable=1.

Request

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

curl "https://api.odds-data-api.com/v3/league/table?league_id=10041282&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": {
    "season": {
      "name": "2026/2027",
      "start_time": "1786060800",
      "end_time": "1810857600",
      "has_leaguetable": 1,
      "has_toplist": 1
    },
    "overall": {
      "tables": [
        {
          "name": "England Premier League",
          "groupname": null,
          "currentround": "4",
          "maxrounds": "38",
          "rows": [
            {
              "pos": "1",
              "sort_pos": "1",
              "change": "0",
              "win": "3",
              "draw": "1",
              "loss": "0",
              "goalsfor": "8",
              "goalsagainst": "2",
              "points": "10",
              "promotion": {
                "name": "Champions League",
                "shortname": "CL"
              },
              "team": {
                "id": "10212",
                "name": "Manchester City",
                "image_id": null,
                "cc": "gb"
              }
            }
          ]
        }
      ]
    },
    "home": {
      "tables": []
    },
    "away": {
      "tables": []
    }
  }
}

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": "league_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/v3/league/table?league_id=10041282&token=YOUR-TOKEN

league_id: 10041282
token: YOUR-TOKEN (from the dashboard)

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