---
title: "GET /events/"
method: GET
path: "/events/"
tags: ["Events"]
---

# GET /events/

`GET /events/`

Get a list of Events

## Query parameters

- `eventID` string
- `eventIDs` string
- `sportID` string
- `leagueID` string
- `type` string
- `oddsAvailable` boolean
- `oddsPresent` boolean
- `oddID` string
- `includeOpposingOdds` boolean
- `includeAltLines` boolean
- `bookmakerID` string
- `teamID` string
- `playerID` string
- `finalized` boolean
- `live` boolean
- `started` boolean
- `ended` boolean
- `cancelled` boolean
- `startsAfter` string, date-time
- `startsBefore` string, date-time
- `limit` number
- `cursor` string

## Response `200`

An array of events

- object
  - `data` Event[]
    - `eventID` string
    - `sportID` string
    - `leagueID` string
    - `type` string
    - `manual` boolean
    - `info` object
      - `seasonWeek` string
    - `players` object
    - `activity` object
      - `count` number
      - `score` number
    - `teams` object
      - `home` object
        - `statEntityID` string
        - `score` number
        - `names` object
          - `short` string
          - `medium` string
          - `long` string
        - `teamID` string
        - `logo` string
        - `colors` object
          - `primaryContrast` string
          - `primary` string
          - `secondary` string
          - `secondaryContrast` string
      - `away` object
        - `statEntityID` string
        - `score` number
        - `names` object
          - `short` string
          - `medium` string
          - `long` string
        - `teamID` string
        - `logo` string
        - `colors` object
          - `primaryContrast` string
          - `primary` string
          - `secondary` string
          - `secondaryContrast` string
    - `results` object
    - `status` object
      - `hardStart` boolean
      - `delayed` boolean
      - `cancelled` boolean
      - `startsAt` string, date-time
      - `started` boolean
      - `displayShort` string
      - `completed` boolean
      - `displayLong` string
      - `ended` boolean
      - `periods` object
        - `started` string[]
        - `ended` string[]
      - `live` boolean
      - `finalized` boolean
      - `reGrade` boolean
      - `currentPeriodID` string
      - `previousPeriodID` string
      - `oddsPresent` boolean
      - `oddsAvailable` boolean
    - `odds` object
  - `nextCursor` string
  - `success` boolean

## Other responses

- `400` — Invalid params
- `401` — Invalid API key
- `403` — Inactive API key
- `404` — No Events found
- `429` — Rate limit exceeded
- `500` — Query failed

---

[API](https://skmtc.net/sportsgameodds/apis/sports-game-odds-api.md) · [All operations](https://skmtc.net/sportsgameodds/apis/sports-game-odds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sportsgameodds/sports-game-odds-api/revisions/37767db05cc7/schema)