History & Settlement Signals

Settlement corrections

Settlements whose result changed after we graded them.

Scorers revise decisions hours after a game, and a grade you already acted on can become wrong. Poll this with a moving since rather than diffing every settlement yourself.

revision is 2 or higher on every row here, and revised_at is when it last changed. graded_at keeps the original settlement time.

Deliberately not cached: the window moves with your cutoff.

Requires the signals entitlement (Max plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/settlements/revisions

Reference context: WKBL.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/settlements/revisions' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "league": "<string>",
    "fixture_id": "<string>",
    "date": "<string>",
    "since": "<string>",
    "count": 0,
    "settlements": [
      {
        "fixture_id": "<string>",
        "league": "<string>",
        "market": "<string>",
        "period": "<string>",
        "participant_id": "<string>",
        "rule": "<string>",
        "status": "<string>",
        "reason_code": "<string>",
        "home_score": 0,
        "away_score": 0,
        "participant_score": 0,
        "player_stat": 0,
        "period_covered": true,
        "outcomes": {
          "home": "won",
          "away": "lost"
        },
        "winning_selection": "<string>",
        "graded_at": "2026-10-29T00:00:00Z",
        "revised_at": "2026-10-29T00:00:00Z",
        "revision": 0
      }
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

Query Parameters

sincestring<date-time>

RFC 3339 timestamp. Defaults to 24 hours ago.

Response

application/json

Corrected settlements.

dataobjectrequired

data.leaguestringrequired

data.fixture_idstring

data.datestring

data.sincestring

data.countintegerrequired

data.settlementsobject[] | nullrequired

data.settlements.fixture_idstringrequired

data.settlements.leaguestringrequired

data.settlements.marketstringrequired

data.settlements.periodstring

data.settlements.participant_idstring

data.settlements.rulestringrequired

data.settlements.statusstringrequired

data.settlements.reason_codestringrequired

data.settlements.home_scoreinteger

data.settlements.away_scoreinteger

data.settlements.participant_scoreinteger

data.settlements.player_statnumber

data.settlements.period_coveredbooleanrequired

data.settlements.outcomesobject

Settlement result keyed by selection identifier (for example home, away, over, under). Values record won, lost, push (stake returned at the line), or void (market did not stand). Join keys to this market's selections; this is not an array.

data.settlements.outcomes.{key}string

data.settlements.winning_selectionstring

data.settlements.graded_atstring<date-time>required

data.settlements.revised_atstring<date-time>

data.settlements.revisionintegerrequired

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.