---
title: "Get fixtures (i.e. sporting events without markets or metadata) for a given sport on a given date"
method: GET
path: "/v2/odds/fixtures"
tags: ["API-Version-2.0"]
---

# Get fixtures (i.e. sporting events without markets or metadata) for a given sport on a given date

`GET /v2/odds/fixtures`

Shows live, upcoming and pre-trading fixtures of a given sport for a given date or time-range.
Also note that a "day" counts as `00:00:00` UTC to `23:59:59` UTC on the requested date.

## Query parameters

- `sport` string, required
- `date` string
- `from` integer
- `to` integer
- `players` boolean
- `limit` integer

## Response `200`

FixturesResponse

- FixturesResponse — FixturesResponse presents a list of upcoming fixtures for a given sport and date
  - `competitions` FixturesCompetition[] — list of all requested competitions and events
    - `category` Identifier — Identifier represents a name-key tuple which together identify a given entity such as a sport
      - `key` string — slug for this Identifier
      - `name` string — name of this Identifier
    - `events` FixtureListEntry[] — list of events which belong to this competition
      - `away` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
        - `abbreviation` string — abbreviation for this team's name
        - `key` string — slug for this Identifier
        - `name` string — name of this Identifier
        - `nationality` string — team country code
      - `cutoffTime` string — event cutoff time in string format "2006-01-02T15:04:05Z07:00" (RFC3339)
      - `home` TeamIdentifier — TeamIdentifier identifies a team competitor for a given event
        - `abbreviation` string — abbreviation for this team's name
        - `key` string — slug for this Identifier
        - `name` string — name of this Identifier
        - `nationality` string — team country code
      - `id` integer — unique ID for this Event
      - `key` string — slug for this Event
      - `name` string — name of this Event
      - `status` 'PRE_TRADING' | 'TRADING' | 'TRADING_LIVE' | 'RESULTED' | 'INTERRUPTED' | 'AWAITING_RESULTS' | 'POST_TRADING' | 'CANCELLED' — EventStatus presents the current status for a given Event
    - `key` string — slug for this Competition. Composed of <sport-key>-<category-key>-<competition-key> as shown in the example value.
    - `name` string — name of this Competition

## Other responses

- `400` — Error
- `401` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/cloudbet/apis/cloudbet-feed-api.md) · [All operations](https://skmtc.net/cloudbet/apis/cloudbet-feed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbet/cloudbet-feed-api/versions/304403f067b1/schema)