Fixture Settlement

curl --request GET \
  --url 'https://v5.oddspapi.io/en/fixtures/settlement?apiKey='

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/en/fixtures/settlement?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/fixtures/settlement?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://v5.oddspapi.io/en/fixtures/settlement?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://v5.oddspapi.io/en/fixtures/settlement?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "fixtureId": "id1400003160574219",
  "status": {
    "live": false,
    "statusId": 2,
    "statusName": "Finished"
  },
  "sport": {
    "sportId": 14,
    "sportName": "American Football"
  },
  "tournament": {
    "tournamentId": 31,
    "tournamentName": "NFL",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": null,
    "seasonName": null,
    "seasonRound": null
  },
  "venue": {
    "venueId": null,
    "venueName": null,
    "venueLocation": null
  },
  "startTime": 1766685600,
  "trueStartTime": "2025-12-25T18:00:17.744256+00:00",
  "trueEndTime": "2025-12-25T21:09:09.345372+00:00",
  "participants": {
    "participant1Id": 4423,
    "participant1RotNr": null,
    "participant1Name": "Minnesota Vikings",
    "participant1ShortName": "Vikings",
    "participant1Abbr": null,
    "participant2Id": 4419,
    "participant2RotNr": null,
    "participant2Name": "Detroit Lions",
    "participant2ShortName": "Lions",
    "participant2Abbr": null
  },
  "scores": {
    "result": {
      "period": "result",
      "participant1Score": 23,
      "participant2Score": 30,
      "updatedAt": "2025-12-25T20:59:04.218194+00:00"
    }
  },
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 15,
  "externalProviders": {
    "betgeniusId": 12281950,
    "betradarId": 60574219,
    "flashscoreId": "lWoCl15F",
    "mollybetId": "2025-12-25,10050390,21622",
    "opticoddsId": "20251225B0C134B3",
    "pinnacleId": 1621042823,
    "sofascoreId": 13897686
  },
  "settlements": [
    {
      "marketId": 141,
      "marketType": "1x2",
      "outcomeId": 142,
      "playerId": 0,
      "status": "WIN",
      "team1Score": 23,
      "team2Score": 30,
      "periods": [
        "fulltime"
      ],
      "margin": 7
    },
    {
      "marketId": 141,
      "marketType": "1x2",
      "outcomeId": 141,
      "playerId": 0,
      "status": "LOSE",
      "team1Score": 23,
      "team2Score": 30,
      "periods": [
        "fulltime"
      ],
      "margin": -7
    }
  ]
}

GET

fixtures

settlement

Fixture Settlement

curl --request GET \
  --url 'https://v5.oddspapi.io/en/fixtures/settlement?apiKey='

const options = {method: 'GET'};

fetch('https://v5.oddspapi.io/en/fixtures/settlement?apiKey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://v5.oddspapi.io/en/fixtures/settlement?apiKey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://v5.oddspapi.io/en/fixtures/settlement?apiKey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://v5.oddspapi.io/en/fixtures/settlement?apiKey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "fixtureId": "id1400003160574219",
  "status": {
    "live": false,
    "statusId": 2,
    "statusName": "Finished"
  },
  "sport": {
    "sportId": 14,
    "sportName": "American Football"
  },
  "tournament": {
    "tournamentId": 31,
    "tournamentName": "NFL",
    "categoryName": "USA"
  },
  "season": {
    "seasonId": null,
    "seasonName": null,
    "seasonRound": null
  },
  "venue": {
    "venueId": null,
    "venueName": null,
    "venueLocation": null
  },
  "startTime": 1766685600,
  "trueStartTime": "2025-12-25T18:00:17.744256+00:00",
  "trueEndTime": "2025-12-25T21:09:09.345372+00:00",
  "participants": {
    "participant1Id": 4423,
    "participant1RotNr": null,
    "participant1Name": "Minnesota Vikings",
    "participant1ShortName": "Vikings",
    "participant1Abbr": null,
    "participant2Id": 4419,
    "participant2RotNr": null,
    "participant2Name": "Detroit Lions",
    "participant2ShortName": "Lions",
    "participant2Abbr": null
  },
  "scores": {
    "result": {
      "period": "result",
      "participant1Score": 23,
      "participant2Score": 30,
      "updatedAt": "2025-12-25T20:59:04.218194+00:00"
    }
  },
  "clock": {
    "currentPeriod": null,
    "currentTime": null,
    "remainingTime": null,
    "remainingTimeInPeriod": null,
    "stopped": null
  },
  "expectedPeriods": 4,
  "periodLength": 15,
  "externalProviders": {
    "betgeniusId": 12281950,
    "betradarId": 60574219,
    "flashscoreId": "lWoCl15F",
    "mollybetId": "2025-12-25,10050390,21622",
    "opticoddsId": "20251225B0C134B3",
    "pinnacleId": 1621042823,
    "sofascoreId": 13897686
  },
  "settlements": [
    {
      "marketId": 141,
      "marketType": "1x2",
      "outcomeId": 142,
      "playerId": 0,
      "status": "WIN",
      "team1Score": 23,
      "team2Score": 30,
      "periods": [
        "fulltime"
      ],
      "margin": 7
    },
    {
      "marketId": 141,
      "marketType": "1x2",
      "outcomeId": 141,
      "playerId": 0,
      "status": "LOSE",
      "team1Score": 23,
      "team2Score": 30,
      "periods": [
        "fulltime"
      ],
      "margin": -7
    }
  ]
}

Authorizations

apiKey

string

query

required

Your API key (query-based auth for v5).

Query Parameters

fixtureId

string

required

Single fixture ID (e.g. id1400003160574219).

outcomeId

integer | null

Optional: restrict settlements to a single outcomeId.

playerId

integer | null

Optional: restrict settlements to a single playerId.

Response

Returns FixtureSettlementResponse (fixture meta + settlements[])

fixtureId

string

required

Fixture identifier: {providerSlug}{sportId}{tournamentId}{nativeId} — see Core Concepts → ID structure.

status

object

required

Lifecycle status of the fixture.

Show child attributes

sport

object

required

Sport reference.

Show child attributes

tournament

object

required

Tournament reference.

Show child attributes

season

object

required

Season reference, when resolved.

Show child attributes

venue

object

required

Venue reference, when known.

Show child attributes

startTime

integer

required

Epoch seconds (UTC).

participants

object

required

Both participants with names, rotation numbers and abbreviations.

Show child attributes

scores

object

required

Score rows keyed by period (result, p1, …).

Show child attributes

clock

object | null

required

Live match clock, while in play.

Show child attributes

externalProviders

object

required

Native identifiers of this fixture at external providers (betradar, pinnacle, …).

settlements

object[]

required

Show child attributes

trueStartTime

string | null

Actual start time (ISO 8601), once known — may differ from the scheduled startTime.

trueEndTime

string | null

Actual end time (ISO 8601), once known.

expectedPeriods

integer | null

Number of regular periods expected for this fixture — use it (with periodLength) to interpret period keys per sport/league.

periodLength

integer | null

Length of a regular period in minutes.

bookmakers

object

Per-bookmaker availability and freshness metadata. Contains only bookmakers that currently offer valid realtime odds for this fixture. Present on fixture and odds endpoints; omitted on CLV, historical-odds and settlement responses.

Show child attributes

Getting Started

Reference

Fixture Settlement

Authorizations

Query Parameters

Response