---
title: "Fixture Settlement"
method: GET
path: "/fixtures/settlement"
tags: ["settlement"]
---

# Fixture Settlement

`GET /fixtures/settlement`

Get settlements for a fixture.

Lookup mode: required `fixtureId` + optional `outcomeId`, optional `playerId`.

## Query parameters

- `fixtureId` string, required
- `outcomeId` integer, nullable
- `playerId` integer, nullable

## Response `200`

Returns FixtureSettlementResponse (fixture meta + settlements[])

- FixtureSettlementResponse
  - `fixtureId` string, required
  - `status` Status, required
    - `live` boolean, required
    - `statusId` integer, required
    - `statusName` string, required
  - `sport` SportRef, required
    - `sportId` integer, required
    - `sportName` string, required
  - `tournament` TournamentRef, required
    - `tournamentId` integer, required
    - `tournamentName` string, required
    - `categoryName` string, nullable
  - `season` SeasonRef, required
    - `seasonId` integer, nullable
    - `seasonName` string, nullable
    - `seasonRound` integer, nullable
  - `venue` VenueRef, required
    - `venueId` integer, nullable
    - `venueName` string, nullable
    - `venueLocation` string, nullable
  - `startTime` integer, required
  - `trueStartTime` string, nullable
  - `trueEndTime` string, nullable
  - `participants` ParticipantsRef, required
    - `participant1Id` integer, required
    - `participant1RotNr` integer, nullable
    - `participant1Name` string, nullable
    - `participant1ShortName` string, nullable
    - `participant1Abbr` string, nullable
    - `participant2Id` integer, required
    - `participant2RotNr` integer, nullable
    - `participant2Name` string, nullable
    - `participant2ShortName` string, nullable
    - `participant2Abbr` string, nullable
  - `scores` object, required
  - `clock` Clock, required
    - `currentPeriod` string, nullable
    - `currentTime` string, nullable
    - `remainingTime` string, nullable
    - `remainingTimeInPeriod` string, nullable
    - `stopped` boolean, nullable
  - `expectedPeriods` integer, nullable
  - `periodLength` integer, nullable
  - `externalProviders` ExternalProviders, required
  - `bookmakers` object, required
  - `settlements` SettlementItem[], required
    - `marketId` integer, nullable
    - `marketType` string, nullable
    - `outcomeId` integer, nullable
    - `playerId` integer, nullable
    - `status` string, nullable
    - `margin` number, nullable
    - `team1Score` integer, nullable
    - `team2Score` integer, nullable
    - `periods` string[], nullable
    - `reason` string, nullable

## Other responses

- `400` — API error
- `401` — API error
- `403` — API error
- `404` — API error
- `422` — Validation Error (framework-level)
- `429` — API error

---

[API](https://skmtc.net/oddspapi/apis/odds-api-v5.md) · [All operations](https://skmtc.net/oddspapi/apis/odds-api-v5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oddspapi/odds-api-v5/revisions/5fe687d7c592/schema)