Skip to main content
GET
/
events
Get Events
curl --request GET \
  --url https://api.odds-api.io/v3/events
[
  {
    "away": "<string>",
    "awayId": 123,
    "date": "<string>",
    "home": "<string>",
    "homeId": 123,
    "id": 123,
    "league": {
      "name": "<string>",
      "slug": "<string>"
    },
    "scores": {
      "away": 123,
      "home": 123
    },
    "sport": {
      "name": "<string>",
      "slug": "<string>"
    },
    "status": "<string>"
  }
]

Query Parameters

apiKey
string
required

API key for authentication

sport
string
required

Sport slug (e.g. football)

league
string

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

participantId
integer

Filter by participant ID (home or away)

status
string

Comma-separated event statuses (e.g. pending,live,settled)

from
string

Start date/time in RFC3339 format (e.g. 2025-10-28T10:00:00Z)

to
string

End date/time in RFC3339 format (e.g. 2025-10-28T23:59:59Z)

bookmaker
string

Filter by bookmaker name - returns only events that have odds available from this bookmaker (e.g. SingBet)

Response

OK

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