---
title: "Discover football tournaments and matchdays"
method: GET
path: "/sportskeeda/football-options"
tags: ["Sportskeeda"]
---

# Discover football tournaments and matchdays

`GET /sportskeeda/football-options`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sportskeeda/football-options`
- Auth: API key in header `x-api-key`

Lists the live football widget's tournament selector. With event, follows the full previous/next matchday chain and returns every currently offered round slug. The discovered values feed sportskeeda-football-data.

## Query parameters

- `event` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsSportskeedaFootballOptionsResponseDoc
  - `data` SportskeedaFootballOptionsResponse
    - `event` string
    - `events` SportskeedaFootballEvent[]
      - `logo` string
      - `name` string
      - `slug` string
    - `matchdays` SportskeedaFootballMatchday[]
      - `end` string
      - `match_count` integer
      - `name` string
      - `selected` boolean
      - `slug` string
      - `start` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

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