By therundown
Updated 12 days ago

TheRundown API Documentation

Real-time scores, schedules, and odds from major sportsbooks. NFL, NBA, WNBA, MLB, NHL, NCAA Football, & NCAA Basketball with more sports soon. Over a dozen sportsbooks currently integrated: 5Dimes, Pinnacle, Matchbook, Betcris, Lowvig, TheGreek, YouWager, Justbet, Tigergaming, Betonline, Bookmaker, Sportsbetting, Intertops & more coming soon. Moneyline, Spread, & Total for full-games, 1st half, 2nd half, 1st Quarter/Period, 2nd Quarter/Period, 3rd Quarter/Period, and 4th Quarter/Period with more markets coming soon. API Documentation: and see more at

Learn more about this API
Affiliates (Sportsbooks)
GETAffiliates (Sportsbooks)
GETDates by sport
Events (Odds)
GETEvents by Sport by Date
GETOpeners by Sport by Date
GETDelta (Changed Events)
GETEvents by sport
GETMoneyline by Line Identifier
GETSpread by Line Identifier
GETTotals by Line Identifier
GETEvents by Sport by Date

The /sports/{sport-id}/events/{date} endpoint to request events for a particular sport on a particular date. The date range defaults to UTC unless an offset query parameter is specified, which is the offset from UTC in minutes. For example, if the request is meant to be made from CDT, the offset should be offset=300 (5 hours). Specifying optional include values may be used to get lines for all markets (instead of just full-game by default) in addition to scores or the team names from specific sportsbooks. To request multiple, simply add multiple values and duplicate the include= parameter in the request like so: &include=allperiods&include=scores. When include=allperiods is used, the key for the lines changes from lines to line_periods. An optional offset in minutes from UTC may be sent in the request to group events by date with an offset. For example, if you are in CDT and want to see events grouped by date in CDT, then specify ?offset=300. Any value of 0.0001 represents the value NotPublished. This means that the sportsbook currently has not published a price or wager for this event, or that the line was removed.

Header Parameters
Required Parameters
REQUIREDThe date (in ISOO8601 format) of the events to return for the sport. Defaults to UTC unless an offset is specified in minutes (see query params)
REQUIREDThe sport-id of the events to return. See the /sports endpoint to get a list of sport-ids.
Optional Parameters
OPTIONAL(Optional) Specifies whether the response should include all available markets (halves/quarters/periods) instead of just full-game by default.
OPTIONAL(Optional) Specifies whether the response should include scores, status, and other game information.
OPTIONALThe offset in minutes from the provided date. The default offset is UTC.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication