---
title: "Settle Bets"
method: POST
path: "/v1/bets/settle"
tags: ["Bet Settlement"]
---

# Settle Bets

`POST /v1/bets/settle`

## Request

- Base URL: `https://api.prop-line.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.prop-line.com/v1/bets/settle`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `apiKey`

Settle placed bets (singles or parlays) against final results.

## Request body

- SettleBetIn[]: Bets to settle: singles or parlays (`legs`).
  - `ref` string, nullable
  - `stake` number, nullable
  - `sport_key` string, nullable
  - `event_id` integer, nullable
  - `market` string, nullable
  - `selection` string, nullable
  - `side` string, nullable
  - `point` number, nullable
  - `period` string, nullable
  - `team` string, nullable
  - `bookmaker` string, nullable
  - `price` integer, nullable
  - `legs` SettleLegIn[], nullable
    - `sport_key` string, required
    - `event_id` integer, required
    - `market` string, required
    - `selection` string, required
    - `side` string, nullable
    - `point` number, nullable
    - `period` string, nullable
    - `team` string, nullable
    - `bookmaker` string, nullable
    - `price` integer, nullable

## Response `200`

Successful Response

- SettleResponse
  - `summary` SettleSummaryOut, required
    - `bets` integer, required
    - `settled` integer, required
    - `pending` integer, required
    - `unmatched` integer, required
    - `won` integer
    - `lost` integer
    - `push_or_void` integer
    - `staked` number, nullable
    - `profit` number, nullable
  - `bets` SettleBetOut[], required
    - `ref` string, nullable
    - `result` string, required
    - `reason` string, nullable
    - `stake` number, nullable
    - `price` integer, nullable
    - `payout` number, nullable
    - `profit` number, nullable
    - `parlay` boolean
    - `legs` SettleLegOut[], required
      - `sport_key` string, required
      - `event_id` integer, required
      - `market` string, required
      - `selection` string, required
      - `side` string, nullable
      - `point` number, nullable
      - `period` string, nullable
      - `team` string, nullable
      - `bookmaker` string, nullable
      - `price` integer, nullable
      - `result` string, required
      - `reason` string, nullable
      - `actual_value` number, nullable
      - `source` string, nullable
      - `outcome_id` integer, nullable
  - `redacted` boolean
  - `upgrade_url` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 89 revisions in range; 4 not diffed.

- **2026-10-28** `70eb2a15ba81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prop-line/apis/player-props-api/changes/v1/bets/settle/post.md)

---

[API](https://skmtc.dev/prop-line/apis/player-props-api.md) - [All operations](https://skmtc.dev/prop-line/apis/player-props-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prop-line/apis/player-props-api/revisions/d3654129ada4?raw)