---
title: "Fixtures Filtered"
method: GET
path: "/fixtures"
tags: ["fixtures"]
---

# Fixtures Filtered

`GET /fixtures`

List fixtures.

Lookup mode: `fixtureIds` OR filters (`sportId`, `tournamentId`, `statusId`, optional time range).

If `bookmakers` is present, bookmaker meta is included and results may be filtered by mapping availability.

## Query parameters

- `fixtureIds` string, nullable
- `sportId` integer, nullable
- `tournamentId` integer, nullable
- `bookmakers` string, nullable
- `startTimeFrom` integer, nullable
- `startTimeTo` integer, nullable

## Response `200`

Returns Fixture[] (fixture meta objects)

- Fixture[]
  - `fixtureId` string, required
  - `status` Status, required
    - `live` boolean, required
    - `statusId` integer, required
    - `statusName` string, required
  - `sport` SportRef, required
    - `sportId` integer, required
    - `sportName` string, required
  - `tournament` TournamentRef, required
    - `tournamentId` integer, required
    - `tournamentName` string, required
    - `categoryName` string, nullable
  - `season` SeasonRef, required
    - `seasonId` integer, nullable
    - `seasonName` string, nullable
    - `seasonRound` integer, nullable
  - `venue` VenueRef, required
    - `venueId` integer, nullable
    - `venueName` string, nullable
    - `venueLocation` string, nullable
  - `startTime` integer, required
  - `trueStartTime` string, nullable
  - `trueEndTime` string, nullable
  - `participants` ParticipantsRef, required
    - `participant1Id` integer, required
    - `participant1RotNr` integer, nullable
    - `participant1Name` string, nullable
    - `participant1ShortName` string, nullable
    - `participant1Abbr` string, nullable
    - `participant2Id` integer, required
    - `participant2RotNr` integer, nullable
    - `participant2Name` string, nullable
    - `participant2ShortName` string, nullable
    - `participant2Abbr` string, nullable
  - `scores` object, required
  - `clock` Clock, required
    - `currentPeriod` string, nullable
    - `currentTime` string, nullable
    - `remainingTime` string, nullable
    - `remainingTimeInPeriod` string, nullable
    - `stopped` boolean, nullable
  - `expectedPeriods` integer, nullable
  - `periodLength` integer, nullable
  - `externalProviders` ExternalProviders, required
  - `bookmakers` object, required

## Other responses

- `400` — API error
- `401` — API error
- `403` — API error
- `404` — API error
- `422` — Validation Error (framework-level)
- `429` — API error

---

[API](https://skmtc.net/oddspapi/apis/odds-api-v5.md) · [All operations](https://skmtc.net/oddspapi/apis/odds-api-v5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oddspapi/odds-api-v5/revisions/5fe687d7c592/schema)