Skip to main content
GET
Search 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

query
string
required

Search term (min 3 characters)

status
enum<string>
default:upcoming

Which events to search: upcoming (default) or live

Available options:
upcoming,
live

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