Events API

Upcoming Events

GET/v3/events/upcoming

Events that have not started yet.

Parameters

Send every parameter in the query string, including token.

Query parameters
Name	Type	Required	Description
token	string	Required	Your API token.
sport_id	integer	Required	R-SportID.
league_id	string	Optional	Only return this league.
team_id	string	Optional	Only return this team's events.
cc	string	Optional	R-Countries, e.g. 'co' for Colombia.
day	string	Optional	Format YYYYMMDD, e.g. 20260913.
skip_esports	boolean	Optional	Skip Esoccer, Ebasketball etc. in the result.
page	integer	Optional	R-Pager. Maximum page is 100.

Request

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

curl "https://api.odds-data-api.com/v3/events/upcoming?sport_id=1&day=20260913&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,
  "pager": {
    "page": 1,
    "per_page": 50,
    "total": 312
  },
  "results": [
    {
      "id": "8211004",
      "sport_id": "1",
      "time": "1789243500",
      "time_status": "0",
      "league": {
        "id": "10041282",
        "name": "England Premier League",
        "cc": "gb"
      },
      "home": {
        "id": "10211",
        "name": "Manchester United",
        "image_id": null,
        "cc": "gb"
      },
      "away": {
        "id": "10202",
        "name": "Chelsea",
        "image_id": null,
        "cc": "gb"
      },
      "ss": null,
      "bet365_id": "158211004"
    }
  ]
}

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": "sport_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/events/upcoming?sport_id=1&day=20260913&token=YOUR-TOKEN

sport_id: 1
day: 20260913
token: YOUR-TOKEN (from the dashboard)

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