---
title: "List Events"
method: GET
path: "/v1/sports/{sport_key}/events"
tags: ["Events & Odds"]
---

# List Events

`GET /v1/sports/{sport_key}/events`

## 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/sports/{sport_key}/events`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `apiKey`

List upcoming events for a sport (no odds — free endpoint).

## Path parameters

- `sport_key` string, required

## Response `200`

Successful Response

- EventOut[]
  - `home_team_key` string, nullable
  - `away_team_key` string, nullable
  - `home_team_id` string, nullable
  - `away_team_id` string, nullable
  - `home_team_logo_url` string, nullable
  - `away_team_logo_url` string, nullable
  - `id` string, required
  - `sport_key` string, required
  - `home_team` string, required
  - `away_team` string, required
  - `commence_time` string, date-time, required
  - `live` boolean
  - `is_outright` boolean
  - `espn_event_id` string, nullable
  - `mlb_game_pk` integer, nullable
  - `tournament` string, nullable
  - `tour` string, nullable
  - `tier` string, nullable
  - `qualifying` boolean, nullable
  - `doubles` boolean, nullable
  - `merged_from_event_ids` string[], nullable
  - `bookmakers` BookmakerOut[], nullable
    - `key` string, required
    - `title` string, required
    - `last_update` string, date-time, nullable
    - `link` string, nullable
    - `app_link` string, nullable
    - `pregame_only` boolean
    - `book_event_id` string, nullable
    - `markets` MarketOut[], required
      - `key` string, required
      - `description` string
      - `last_update` string, date-time, required
      - `period` string, nullable
      - `suspended_at` string, date-time, nullable
      - `team` string, nullable
      - `line_type` string
      - `outcomes` OutcomeOut[], required
        - `name` string, required
        - `description` string, required
        - `price` integer, nullable, required
        - `point` number, nullable, required
        - `book_updated_at` string, date-time, nullable
        - `book_version` integer, nullable
        - `payout_multiplier` number, nullable
        - `dfs_odds_type` string, nullable
        - `last_change_at` string, date-time, nullable
        - `last_seen_at` string, date-time, nullable
        - `liquidity` number, nullable
        - `liquidity_updated_at` string, date-time, nullable
        - `depth` DepthLevelOut[], nullable
          - `price` integer, required
          - `size` number, nullable
        - `allowed_wager_types` string, nullable
        - `line_gap` number, nullable
        - `book_outcome_id` string, nullable
        - `book_outcome_id_ontario` string, nullable
        - `outcome_id` integer, nullable
        - `player_id` string, nullable
        - `side` string, nullable
        - `line_type` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 89 revisions in range; 4 not diffed.

- **2026-10-24** `a90053a73148`: 1 info
  - added the optional property `items/bookmakers/anyOf[subschema #1]/items/markets/items/outcomes/items/book_outcome_id_ontario` to the response with the `200` status
- **2026-10-21** `b4e270bfaa07`: 3 info
  - added the optional property `items/doubles` to the response with the `200` status
  - added the optional property `items/qualifying` to the response with the `200` status
  - added the optional property `items/tier` to the response with the `200` status
- **2026-10-17** `8db25901f2d5`: 1 info
  - added the optional property `items/bookmakers/anyOf[subschema #1]/items/markets/items/outcomes/items/allowed_wager_types` to the response with the `200` status
- **2026-10-01** `854f3fa56312`: 2 info
  - added the optional property `items/bookmakers/anyOf[subschema #1]/items/markets/items/line_type` to the response with the `200` status
  - added the optional property `items/bookmakers/anyOf[subschema #1]/items/markets/items/outcomes/items/line_type` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/prop-line/apis/player-props-api/changes/v1/sports/:sport_key/events/get.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)