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>",
    "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)

​
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). If omitted, defaults to 14 days from now.

​
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. Every response is capped at 5000; use limit + skip to paginate larger ranges.

​
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
​
clock
object

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