---
title: "In-Game Odds Line Movement"
method: GET
path: "/v3/cfb/odds/{format}/LiveGameOddsLineMovement/{gameid}"
tags: ["CFB v3 Odds"]
---

# In-Game Odds Line Movement

`GET /v3/cfb/odds/{format}/LiveGameOddsLineMovement/{gameid}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/cfb/odds/{format}/LiveGameOddsLineMovement/{gameid}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/cfb-api/docs/v3/cfb/odds/:format/LiveGameOddsLineMovement/:gameid/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.

## Path parameters

- `format` 'JSON' | 'XML', required
- `gameid` string, required

## Response `200`

Success

- GameInfo[]
  - `GameId` integer: The unique ID of this game
  - `Season` integer: The college football season of the game
  - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
  - `Week` integer, nullable: The week of the game
  - `Day` string, nullable: The date of the game
  - `DateTime` string, nullable: The date and time of the game (in US Eastern Time)
  - `Status` string, nullable: The status of the game. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit
  - `AwayTeamId` integer, nullable: The unique ID of the away team
  - `HomeTeamId` integer, nullable: The unique ID of the home team
  - `AwayTeamName` string, nullable: The name of the away team
  - `HomeTeamName` string, nullable: The name of the home team
  - `GlobalGameId` integer: A globally unique ID for this game. Note: This value is guaranteed to be unique across all sports/leagues
  - `GlobalAwayTeamId` integer, nullable: A globally unique ID for the away team. Note: This value is guaranteed to be unique across all sports/leagues
  - `GlobalHomeTeamId` integer, nullable: A globally unique ID for the home team. Note: This value is guaranteed to be unique across all sports/leagues
  - `PregameOdds` GameOdd[]: List of Pregame Odds from different sportsbooks
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: The name of the sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time)
    - `Updated` string, nullable: The timestamp of when these odds were last updated, based on US Eastern Time (EST/EDT). If these are the latest odds for this game, and they have not been updated within the last few minutes, then it indicates that there were problems connecting to the sportsbook
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw
    - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team
    - `OverUnder` number, nullable: The sportsbook's total points line at game start
    - `OverPayout` integer, nullable: The sportsbook's payout for the over in the total points line
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: The unique ID of the sportsbook
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; etc)
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `Unlisted` string, nullable: The timestamp of when these odds were no longer seen (US Eastern Time)
  - `LiveOdds` GameOdd[]: List of Live Odds from different sportsbooks
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: The name of the sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time)
    - `Updated` string, nullable: The timestamp of when these odds were last updated, based on US Eastern Time (EST/EDT). If these are the latest odds for this game, and they have not been updated within the last few minutes, then it indicates that there were problems connecting to the sportsbook
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw
    - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team
    - `OverUnder` number, nullable: The sportsbook's total points line at game start
    - `OverPayout` integer, nullable: The sportsbook's payout for the over in the total points line
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: The unique ID of the sportsbook
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; etc)
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `Unlisted` string, nullable: The timestamp of when these odds were no longer seen (US Eastern Time)
  - `HomeTeamScore` integer, nullable: Score of the home team (updated after game ends to allow for resolving bets)
  - `AwayTeamScore` integer, nullable: Score of the away team (updated after game ends to allow for resolving bets)
  - `TotalScore` integer, nullable: The total points scored by both teams in the game tied to this event (updated after game ends to allow for resolving bets)
  - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
  - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game
  - `AlternateMarketPregameOdds` GameOdd[]: List of Alternate Market Pregame Odds from different sportsbooks
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: The name of the sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time)
    - `Updated` string, nullable: The timestamp of when these odds were last updated, based on US Eastern Time (EST/EDT). If these are the latest odds for this game, and they have not been updated within the last few minutes, then it indicates that there were problems connecting to the sportsbook
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw
    - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team
    - `OverUnder` number, nullable: The sportsbook's total points line at game start
    - `OverPayout` integer, nullable: The sportsbook's payout for the over in the total points line
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: The unique ID of the sportsbook
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; etc)
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `Unlisted` string, nullable: The timestamp of when these odds were no longer seen (US Eastern Time)

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/cfb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cfb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cfb-api/revisions/2937cc5c9322?raw)
