Skip to main content
GET
/
events
Get Events
curl --request GET \
  --url https://api.odds-api.io/v3/events
[
  {
    "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>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.odds-api.io/llms.txt

Use this file to discover all available pages before exploring further.

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)

​
limit
integer

Maximum number of events to return

​
skip
integer

Number of events to skip (for pagination)

Response

OK

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