Skip to main content
GET
Get Historical Events

Authorizations

apiKey
string
query
required

Your Odds-API.io API key, sent as the apiKey query parameter. Get one at https://odds-api.io/pricing.

Query Parameters

apiKey
string
required

API key for authentication

sport
string
required

Sport name or slug (e.g. Football or football)

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

OK

away
string
awayId
integer
bookmakerCount
integer
date
string
home
string
homeId
integer
id
integer
league
object
scores
object
sport
object
status
string
replacedBy
integer

Set only on a cancelled event that was re-issued under a new id (for example with home and away corrected): the id of the event to use instead. Omitted otherwise.

Example:

72710126

clock
object

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

esports
object

Esports events only: game, parent league, region and match format