Get live NFL scores

GET/v1/nfl/scores/live

Real-time scores for every active NFL game with quarter, clock, possession, down & distance, and yardline.

Code samples

# Get NFL play-by-play for a game
curl "https://api.sportapi.io/v1/nfl/games/2024_09_KC_BUF/play-by-play" \
  -H "Authorization: Bearer $API_KEY"

# Each play with EPA, win probability, formation
{
  "plays": [{
    "qtr": 3, "down": 3, "distance": 7,
    "yardline": "BUF 38", "clock": "05:42",
    "description": "P. Mahomes pass deep right to T. Kelce for 38 yards, TOUCHDOWN",
    "epa": 4.21, "wpa": 0.18,
    "formation": "shotgun", "play_type": "pass"
  }]
}

Query parameters

Parameter	Type	Required	Description
`team`	string	No	Filter by team (e.g. KC)
`since`	string	No	ISO 8601 timestamp

Response

{
  "games": [{
    "game_id": "2024_09_KC_BUF",
    "status": "in_progress",
    "quarter": 3, "clock": "05:42",
    "possession": "KC", "down": 3, "distance": 7, "yardline": "BUF 38",
    "home": { "team": "BUF", "score": 17 },
    "away": { "team": "KC", "score": 24 }
  }]
}

Error responses

Status	Code	Description
401	`unauthorized`	Missing or invalid API key
403	`tier_insufficient`	Your plan tier doesn't include this resource
429	`rate_limited`	Exceeded rate limit; honor Retry-After
500	`internal_error`	Server error; retry with exponential backoff