Get Historical Events

Returns finished events for a given sport and league within a date range. Maximum date span is 31 days. Historical data is available from December 2025 onwards.

GET /historical/events

Get Historical Events

cURL

curl --request GET \
  --url https://api.odds-api.io/v3/historical/events

200

[
  {
    "away": "<string>",
    "awayId": 123,
    "bookmakerCount": 123,
    "date": "<string>",
    "home": "<string>",
    "homeId": 123,
    "id": 123,
    "league": {
      "name": "<string>",
      "slug": "<string>"
    },
    "scores": {
      "away": 123,
      "home": 123,
      "periods": {}
    },
    "sport": {
      "name": "<string>",
      "slug": "<string>"
    },
    "status": "<string>",
    "clock": {
      "minute": 67,
      "playedSeconds": 4023,
      "period": 2,
      "running": true,
      "statusDetail": "2nd half",
      "injuryTime": 4
    }
  }
]

Query Parameters

apiKey · string · required

API key for authentication

sport · string · required

Sport slug (e.g. football, basketball)

league · string · required

League slug (e.g. england-premier-league)

from · string · required

Start date in RFC3339 format

to · string · required

End date in RFC3339 format

Response

200

application/json

OK

away · string

awayId · integer

bookmakerCount · integer

date · string

home · string

homeId · integer

id · integer

league · object

Show child attributes

scores · object

Show child attributes

sport · object

Show child attributes

status · string

clock · object

Live match clock (live events only; absent when no clock data is available)

Show child attributes