---
title: "GET /results"
method: GET
path: "/results"
tags: ["Results"]
---

# GET /results

`GET /results`

## Request

- Base URL: `https://api.sockodds.com/v1`
- URL: `https://api.sockodds.com/v1/results`
- Auth: HTTP bearer

Settled outcomes for finished events, graded from official result sources. Each outcome's `verdict` is `won`, `lost`, `void` (stake returned) or `dead_heat`. A dead heat pays `dead_heat_factor` of the stake at the quoted price and loses the rest: a drawn AFL or AFLW head-to-head, a drawn AFLW quarter or half winner, and a Rugby League World Cup head-to-head still level after golden point, is a dead heat with a factor of 0.5. Outcomes that official evidence cannot settle are left out, never guessed. Each market settles on its own once official evidence settles all of its outcomes, so a result can be published while other markets on the event are still pending: `settlement` is `partial` and `pending_markets` counts them, and later results for the same event add the newly settled outcomes without changing any verdict already published.

## Query parameters

- `league` string
- `event_id` string
- `starts_after` string, date-time
- `starts_before` string, date-time
- `cursor` string
- `limit` integer

## Response `200`

Results

- ResultsEnvelope
  - `data` Result[], required
    - `event` Event, required
      - `id` string, required
      - `name` string, required
      - `league` NamedKey, required
        - `key` string, required
        - `name` string, required
      - `scheduled_start` string, date-time, required
      - `status` 'scheduled' | 'live' | 'final' | 'postponed' | 'cancelled', required
      - `participants` Participant[], required
        - `role` 'home' | 'away' | 'competitor_1' | 'competitor_2', required: home and away in team sports. In tennis and UFC
        - `identity` union, required
          - NamedKey
            - `key` string, required
            - `name` string, required
          - object
            - `id` string, required
            - `name` string, required
    - `status` 'final' | 'corrected', required
    - `settlement` 'complete' | 'partial', required: complete when every quoted market on the event is settled; partial while any market is still pending.
    - `pending_markets` integer, required: How many quoted markets on the event are still pending. A market is pending until official evidence settles every one of its outcomes.
    - `settled_at` string, date-time, required
    - `outcomes` object[], required
      - `id` string, required
      - `name` string, required
      - `verdict` 'won' | 'lost' | 'void' | 'dead_heat', required
      - `dead_heat_factor` number: Dead heats only: the share of the stake paid at the quoted price. The rest of the stake is lost.
      - `market` RecordedMarket, required
        - `id` string, required
        - `key` string, required
        - `name` string, required
        - `period` string, required
        - `subject` union, required
          - NamedKey
            - `key` string, required
            - `name` string, required
          - object
            - `id` string, required
            - `name` string, required
      - `side` string, required
      - `line` number, nullable, required
  - `meta` Meta, required
    - `count` integer, required
    - `cursor` string, nullable, required
  - `links` Links, required
    - `next` string, uri-reference, nullable, required

## Other responses

- `default`: Request failed

---

[API](https://skmtc.dev/sockodds/apis/sockodds-api.md) · [All operations](https://skmtc.dev/sockodds/apis/sockodds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sockodds/apis/sockodds-api/revisions/f4c680d355be?raw)