Endpoints

Get Scores

GET/v1/sports/{sport_key}/scoresAPI key

Returns scores for a sport, with period-by-period detail. Use status=live to follow in-progress events.

Path parameters

Name	Type	Required	Description
`sport_key`	string	required	Sport key, e.g. nfl.

Query parameters

Name	Type	Required	Description
`status`	string	optional	scheduled, live or final. Defaults to all.
`event_ids`	string	optional	Comma-separated event IDs.
`limit`	integer	optional	Max records. Default 100, max 500.

Request

cURL

curl "https://api.openoddsapi.com/v1/sports/nfl/scores?status=final" \
  -H "X-API-Key: sk_test_your_key_here"

JavaScript

const res = await fetch(
  "https://api.openoddsapi.com/v1/sports/nfl/scores?status=final",
  { headers: { "X-API-Key": "sk_test_your_key_here" } }
);
const scores = await res.json();
console.log(scores);

Python

import requests

url = "https://api.openoddsapi.com/v1/sports/nfl/scores"
res = requests.get(
    url,
    params={"status": "final"},
    headers={"X-API-Key": "sk_test_your_key_here"},
)
print(res.json())

200 OK — array of score objects

JSON

[
  {
    "event_id": "evt_nfl_20260910_chiefs_bills",
    "sport_key": "nfl",
    "status": "final",
    "home_team": "Kansas City Chiefs",
    "away_team": "Buffalo Bills",
    "home_score": 27,
    "away_score": 24,
    "periods": [
      { "number": 1, "home_score": 7, "away_score": 3 },
      { "number": 2, "home_score": 10, "away_score": 7 },
      { "number": 3, "home_score": 3, "away_score": 7 },
      { "number": 4, "home_score": 7, "away_score": 7 }
    ],
    "updated_at": "2026-09-11T03:55:12Z"
  }
]

For golf, home_score/away_score are null and periods lists round-by-round totals for the leaders. For combat sports, the winner is indicated by a winner field set to the fighter name.