Skip to main content
GET
/
api
/
v2
/
sports
/
{sportID}
/
events
/
{date}
Get events with markets for a sport and date
curl --request GET \
  --url 'https://therundown.io/api/v2/sports/{sportID}/events/{date}?key='
{
  "meta": {
    "delta_last_id": "11ef-abcd-1234-5678-9012-abcdef123456"
  },
  "events": [
    {
      "event_id": "816efd1e5767d7133b5bc70c77173a18",
      "sport_id": 4,
      "event_uuid": "11f1-197d-e93ea800-8c2a-ef6a554ca62d",
      "event_date": "2026-01-15T00:00:00Z",
      "score": {
        "event_status": "STATUS_SCHEDULED",
        "score_away": 0,
        "score_home": 0,
        "game_period": 0,
        "game_clock": 0
      },
      "teams": [
        {
          "team_id": 145,
          "name": "Los Angeles",
          "mascot": "Lakers",
          "abbreviation": "LAL",
          "record": "38-18",
          "is_away": true,
          "is_home": false
        },
        {
          "team_id": 153,
          "name": "Boston",
          "mascot": "Celtics",
          "abbreviation": "BOS",
          "record": "42-14",
          "is_away": false,
          "is_home": true
        }
      ],
      "schedule": {
        "event_name": "Los Angeles Lakers at Boston Celtics",
        "season_type": "Regular Season",
        "season_year": 2026
      },
      "markets": [
        {
          "market_id": 1,
          "period_id": 0,
          "name": "moneyline",
          "participants": [
            {
              "id": 145,
              "type": "TYPE_TEAM",
              "name": "Los Angeles Lakers",
              "lines": [
                {
                  "value": "",
                  "prices": {
                    "19": {
                      "price": 150,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    },
                    "23": {
                      "price": 155,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:28:00Z"
                    }
                  }
                }
              ]
            },
            {
              "id": 153,
              "type": "TYPE_TEAM",
              "name": "Boston Celtics",
              "lines": [
                {
                  "value": "",
                  "prices": {
                    "19": {
                      "price": -180,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    },
                    "23": {
                      "price": -185,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:28:00Z"
                    }
                  }
                }
              ]
            }
          ]
        },
        {
          "market_id": 2,
          "period_id": 0,
          "name": "handicap",
          "participants": [
            {
              "id": 145,
              "type": "TYPE_TEAM",
              "name": "Los Angeles Lakers",
              "lines": [
                {
                  "value": "4.5",
                  "prices": {
                    "19": {
                      "price": -110,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    },
                    "23": {
                      "price": -108,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:28:00Z"
                    }
                  }
                }
              ]
            },
            {
              "id": 153,
              "type": "TYPE_TEAM",
              "name": "Boston Celtics",
              "lines": [
                {
                  "value": "-4.5",
                  "prices": {
                    "19": {
                      "price": -110,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    },
                    "23": {
                      "price": -112,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:28:00Z"
                    }
                  }
                }
              ]
            }
          ]
        },
        {
          "market_id": 3,
          "period_id": 0,
          "name": "totals",
          "participants": [
            {
              "id": 1001,
              "type": "TYPE_RESULT",
              "name": "Over",
              "lines": [
                {
                  "value": "224.5",
                  "prices": {
                    "19": {
                      "price": -110,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    }
                  }
                }
              ]
            },
            {
              "id": 1002,
              "type": "TYPE_RESULT",
              "name": "Under",
              "lines": [
                {
                  "value": "224.5",
                  "prices": {
                    "19": {
                      "price": -110,
                      "is_main_line": true,
                      "updated_at": "2026-01-14T22:30:00Z"
                    }
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

​
key
string
query
required

API key as query parameter

Path Parameters

​
sportID
integer
required

Sport ID. Common values: 1=NCAAF, 2=NFL, 3=MLB, 4=NBA, 5=NCAAB, 6=NHL, 7=UFC, 8=WNBA, 9=CFL, 10=MLS, 11=EPL, 16=UEFA Champions League, 33=UEFA Europa League, 38=ATP Tennis, 39=WTA Tennis

​
date
string<date>
required
Example:

"2026-01-15"

Query Parameters

​
offset
integer
default:0

UTC offset in minutes for the date boundary. Use 300 for US Central, 240 for Eastern, 360 for Mountain, 420 for Pacific. Without this, the API day boundary is midnight UTC.

Example:

300

​
market_ids
string
default:1,2,3

Comma-separated market IDs. Defaults to 1,2,3 (Moneyline, Spread, Total). Limit: 12 market IDs per request. IDs beyond the 12th are silently ignored. Common IDs: 1=Moneyline, 2=Spread, 3=Total, 29=Player Points, 35=Player Rebounds, 38=Three Pointers, 39=Player Assists, 93=Player PRA, 94=Team Totals. Live variants: 41=Live ML, 42=Live Spread, 43=Live Total. If you need more than 12 markets, make multiple requests.

​
participant_ids
string

Comma-separated participant IDs to filter (max 99)

​
participant_type
enum<string>

Filter participants by type

Available options:
TYPE_TEAM,
TYPE_PLAYER,
TYPE_RESULT
​
affiliate_ids
string

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), Bovada (2), Pinnacle (3).

​
main_line
enum<string>
default:false

Only return main lines (primary odds, not alternates)

Available options:
true,
false
​
hide_no_markets
enum<string>
default:false

Hide events with no market data

Available options:
true,
false
​
exclude_status
string

Comma-separated event status strings to exclude

Response

200 - application/json

Events with markets

​
meta
object
​
events
object[]